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Radio and Television Interference 


The equipment described in this manual generates and uses 
radio-frequency energy. If it is not installed and used properly— that is, in 
strict accordance with our instructions — it may cause interference with 
radio and television reception. 

This equipment has been tested and complies with the limits for a Class B 
computing device in accordance with the specifications in Subpart J, 

Part 15, of FCC rules. These rules are designed to provide reasonable 
protection against such interference in a residential installation. However, 
there is no guarantee that the interference will not occur in a particular 
installation, especially if a “rabbit ear” television antenna (the 
telescoping-rod type) is used. 

You can determine whether your computer is causing interference by 
turning it off. If the interference stops, it was probably caused by the 
computer or its peripherals. To further isolate the problem, disconnect the 
peripheral devices and their input/output cables one at a time. If the 
interference stops, it was caused by either the peripheral device or the I/O 
cable. These devices usually require shielded I/O cables. For Apple 
peripherals, you can obtain the proper shielded cable from your dealer. For 
non-Apple peripheral devices, contact the manufacturer or dealer for 
assistance. 

If your computer does cause interference to radio or television reception, 
you can try to correct the interference by doing one or more of the following: 

□ Turn the television or radio antenna until the interference stops. 

□ Move the computer to one side or the other of the television or radio. 

□ Move the computer farther away from the television or radio. 

□ Plug the computer into an outlet that is on a different circuit than the 
television or radio. (That is, make certain the computer and the radio or 
TV are on circuits controlled by different circuit breakers or fuses.) 

□ Consider installing a rooftop television antenna with coaxial cable lead-in 
between the antenna and television. 

If necessary, you should consult your Apple-authorized dealer or an 
experienced radio/tele vision technician for additional suggestions. 
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Preface 


About This Manual 


This is the reference manual for the Apple® lie personal computer. You will 
find a description here of all the hardware and firmware components of the 
Apple lie. 

The information in this manual is aimed at assembly-language 
programmers and hardware designers, but others interested in the internal 
operation of the Apple lie can also benefit from reading it. 

This manual tells you how the Apple lie works, but not how to use the 
Apple lie. If you need to know this, you should read other Apple lie 
manuals, particularly the Apple lie Owner’s Manual. 

This manual describes two versions of the Apple lie: the original Apple lie 
and a newer version that supports UniDisk™ 3.5. Information specific to the 
newer version of the machine is marked throughout the manual with 
UniDisk 3.5 in the margin of the text. If you buy a UniDisk 3.5 for your 
original lie, your dealer will install a new ROM to make your lie equivalent 
to the newer version. 

The following features have been added to the built-in firmware in the 
newer lie: 

□ the Protocol Converter (Chapter 6) 

□ some new serial port commands (Chapters 7 and 8) 

□ the Mini-Assembler (Chapter 10) 

□ new Monitor commands STEP and TRACE (Chapter 10) 

Changes have also been made to the built-in interrupt and mouse-interrupt 
handlers (Chapter 9 and Appendix E) and external drive startup procedures 
(Chapter 6). 

Which Version Do You Have? You can quickly tell which version of 
the Apple lie you have by checking the value of ROM location 64447 
($FBBF hexadecimal). From Applesoft type print peek( 64447 >. The 
value printed is 255 if your Apple lie is an original version, and 0 if your 
Apple lie supports UniDisk 3.5. 
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Contents of This Manual 


The Apple lie is presented here from the outside in. 

Chapter 1 introduces the major physical features of the Apple lie, including 
external controls and connectors and the major internal components of the 
machine. 

Chapter 2 introduces the 65C02 microprocessor, which is the heart of the 
Apple lie. It discusses the processor’s address space, what resides in that 
space, and how to control it. 

Chapter 3 introduces the I/O characteristics of the Apple lie. Chapters 4 
through 9 cover specific I/O devices. 

□ Chapter 4 describes the keyboard and speaker. 

□ Chapter 5 describes the video display. 

□ Chapter 6 describes the disk drive and the Protocol Converter. 

□ Chapter 7 describes serial port 1, generally used to control printers. 

□ Chapter 8 describes serial port 2, generally used to control modems. 

□ Chapter 9 describes the mouse, game paddle, and joystick port. 

Chapter 10 covers the Monitor built into the Apple lie’s firmware. The 
Monitor helps you write, disassemble, and debug machine-language 
programs and inspect and manipulate Apple lie memory contents. 

Chapter 11 describes in detail the Apple He’s hardware. It is intended to 
help programmers, but others may find the description useful. 

Appendix A describes the differences between the 6502 used on most 
members of the Apple II family and the 65C02 used by the Apple lie and 
enhanced Apple lie. Most of the chapter is a reprint of the manufacturer’s 
data sheet for the 65C02. 

Appendix B contains a memory map of the Apple lie including detailed 
maps of page $00, page $03, the screen holes, and the hardware page. 

Appendix C lists the published entry points of the Apple lie’s firmware. The 
list, arranged by address, includes the I/O firmware ($C300 through 
$CFFF) and the Monitor firmware ($F000 through $FFFF). Addresses for 
the Applesoft interpreter firmware ($D000 through $F7FF) are listed in the 
Applesoft BASIC Programmer's Reference Manual. 

Appendix D discusses some of the most common operating systems and 
languages that run on the Apple lie, and what special features of the 
machine they do or don’t use. 
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Appendix E describes how the Apple He’s interrupt firmware operates and 
how to use it in your own programs. 

Appendix F outlines the differences and similarities between the different 
members of the Apple II family. 

Appendix G describes the keyboard layouts, code conversion tables, and 
external power requirements of USA and international models of the Apple 
lie. 

Appendix H contains tables to aid you in code and number base 
conversions. 

Appendix I is a listing of the source code of the firmware of the version of 
the lie that supports UniDisk 3.5. If you find that you absolutely must 
develop software or hardware for an original lie that will not be upgraded 
in the future, you can get a listing of the old source code by filling out and 
mailing the order form in the back of this manual. 

The glossary defines many of the technical terms used in this manual. 

The bibliography lists articles and books with additional information about 
the Apple lie and related products. 

Finally, after the index at the back of this manual there is a Tell Apple 
Card. Please fill it out and send it in. Your experience with the manual can 
help us plan new reference materials. 


Symbols Used in This Manual 


This manual uses a numbering system to make it easier to cross-reference 
information. A reference like 2.4.6 means Chapter 2, Section 4, subsection 6. 
A reference like F.6.2 refers to Appendix F, Section 6, subsection 2. 


Look for these visual cues throughout the manual: 


▲Warning 

Important! 


Important information about your safety or the safety of your data 
appears like this. 

Text set off like this— and with a tag in the margin— presents important 
information. 


UniDisk 3.5 


Text set off like this presents information specific to the newer lie, which 
supports UniDisk 3.5. 


Symbols Used in This Manual 
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Cross-references and definitions appear in 
marginal notes like this. 
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By the Way: Text set off this way presents incidental information that 
you may find interesting. 

You will also see a special typeface used for what you type or for text that 
appears on your video display: 

It looks like this. 

Keys look like this: Q [5], | return | . When you see a hyphen joining two 
keys, it means to press them simultaneously. For instance, 
fo>l control H reset | means all three keys should be pressed at the same 
time. 
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This chapter introduces you to the working parts of the Apple® lie by 
briefly describing the major components of the computer— both internal 
and external hardware and firmware— and telling you where in the manual 
to find out more about them. 


1.1 Outside of Machine 


This section briefly describes the Apple He’s keyboard, controls, indicators, 
and expansion connectors. 

The Apple lie comes equipped with a keyboard, speaker (with audio output 
jack and volume control), built-in disk drive, external power supply, and 
internal voltage converter. It also has built-in interfaces with external 
connectors for a serial printer, video monitor, special video display adapters, 
modem, mouse, and game controllers. These external connectors allow you 
to plug in accessory equipment without having to go inside the machine to 
use expansion slots like those in the Apple He. 

Figure 1-1 shows the front and right side of an Apple lie, and Figure 1-2 
shows the back and left side. 


Figure 1-1. Apple lie External Figure 1-2. Apple lie External 

Features (Front) Features (Back) 



Keyboard Disk Drive 

(See Figs. 1-4 and 1-5) (See Fig. 1-7) 


Back Panel 
(See Fig. 1-8) 


Speaker 
Volume Control 
(See Fig. 1-6) 
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1.1.1 The Keyboard 


ASCII stands for American Standard Code 
for Information Interchange. Table 4-2 lists 
the ASCII character encoding for the 
standard and simplified USA keyboards. 
Appendix G lists the encoding for 
international keyboards. 


The Apple He’s primary input device is the keyboard, shown in Figure 1-3. 
The keyboard has a 63-key typewriter layout with both uppercase and 
lowercase characters and can generate all 128 standard ASCII characters. A 
reset key, 80/40-column display selector switch, keyboard layout selector 
switch, disk-use light, and power light are also located on the front of the 
computer. 

Figure 1-3. Front of Apple lie With Standard USA Keyboard 
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Table 1-1, on the next page, lists the characteristics of all Apple lie 
keyboards and front panels. 

Features 

The Apple lie keyboard has automatic repeat on all character keys. This 
means that if you hold the key down longer than about a second, the 
character it generates repeats until you let up the key. It also has two-key 
rollover, which means if you press a key before releasing the one you 
pressed before it, the second character enters the computer the same as 
though you had released the previous key first. (This is important for fast 
touch-typists.) 


1.1 Outside of Machine 
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TablelA. Keyboard Specifications 


The El and [¥] keys are connected to 1-bit 
addresses in memory, described in 
Chapter 9. 


Chapter 2 describes the results of the 
various reset procedures. 


Number of keys: 
Character encoding: 
Number of codes: 
Features: 

Special function keys: 
Cursor movement keys: 
Modifier keys: 

Front panel switches: 
Front panel lights: 


63 

ASCII 

128 

Automatic repeat, two-key rollover 

I RESET I , fol, m 

El El CD, 13, 1 RETURN 1. 1 DELETE I, ItABI 

I CONTROL 1 . 1 SHIFT I, I CAPS LOCK | , flSCl 

80/40 switch, keyboard switch 
Power light, disk-use light 


Special Function Keys 

The Apple lie keyboard has three special function keys: | reset |, and two 
keys marked with apples— one outlined, [a], and one filled in, fi~|. 

[ reset | has a direct line to the 65C02 microprocessor’s RESET signal line 
(see Chapter 11): holding down | control | while pressing [ reset I causes 
the Apple lie to restart processing with an internal firmware program that 
puts the machine in a known state (see Chapter 2). 

You can restart the Apple lie without turning the power off and back on 
again, by holding down both | control I and [5] while pressing | reset | . 
Restarting this way is less stressful to the Apple He’s components than 
normal powerup. 

Cursor Movement Keys 

The Apple lie keyboard has four cursor movement keys with arrows 
marked on them: left, right, down, and up. Three other keys can also cause 
cursor movements: | return |, | delete I, and | tab I . All seven of these keys 
generate ASCII control characters (see Table 4-2). It is up to the operating 
system or application program to interpret and act on the control codes that 
these keys generate. 
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The Monitor is a built-in program that 
performs some of the basic activities of the 
computer, such as retrieving and storing 
key codes as they come in, and clearing or 
updating the display screen. 


Important! 


Modifier Keys 

Three special keys — | control ] , I shift |, and I caps lock"! — generate no 
codes when pressed by themselves, but change the codes generated by 
other keys they are pressed in combination with. A fourth key, | esc |, 
generates a nonprinting control code that causes the Monitor to interpret 
certain subsequent keystrokes in a modified way. 

□ | control | . when pressed in combination with letter keys or certain 
other keys, produces ASCII control characters. Most of the control 
characters are invisible most of the time. 

□ | shift | works the same on the Apple lie as on an ordinary typewriter: it 
selects uppercase letters and the upper characters on the keys. 

□ I caps lockI , in its down position, changes the letter keys to uppercase, 
but does not affect other keys. 

□ |~esc~| is not a modifier key in the same sense as | control | and I shift | : 
you do not hold it down while pressing other keys. Rather, you press 
risc~| and it generates the ASCII escape (ESC) control character (key 
code $1B— see Table 4-2). When the |~es51 key is pressed, many 
programs— including the built-in Monitor program— then interpret other 
specific keys as designating an escape sequence. 

The 80/40 Switch 

The 80/40 switch lets you specify whether a program should display 
information in 40 or 80 columns per line. The switch indicates 40-column 
display when in its down position, and 80-column display when in its up 
position. 

Not all programs check this switch. Even programs that do check the 
switch may do so only when the program first starts up. If that is the 
case, changing the switch position while the program is running will have 
no effect on the program’s display. (See Table 4-1.) 

The Keyboard Switch 

You use the keyboard switch to select for use one of the two keyboard 
layouts and screen character sets built into your Apple lie. On USA versions 
of the Apple lie, you select the standard Sholes keyboard layout (Figure 1-4) 
with the switch in the up position, and the Dvorak simplified layout (Figure 
1-5) with the switch in the down position. 

If you normally use the Dvorak keyboard layout, you can gently pry up the 
keys from the keyboard and rearrange and replace them in their Dvorak 
positions. 


1.1 Outside of Machine 
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Figure 1-4. USA Standard or Sholes Keyboard (Keyboard Switch Up) 



Figure 1-5. USA Simplified or Dvorak Keyboard (Keyboard Switch Down) 
Note : Shaded^ characters may be in different positions on some models. 
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Appendix G illustrates the keyboard 
layouts for both keyboard switch positions 
on several international versions of the 
Apple lie. 


▲Warning 


The way programs control the speaker is 
described in Section 4.2. 


On international models, the keycaps indicate the character positions for 
the local keyboard layout, which is selected when the keyboard switch is 
down. When up, the keyboard switch selects the USA standard characters 
and key layout. 


Disk-Use and Power Lights 

The red disk-use light glows whenever the built-in disk drive’s motor is 
switched on. 

The green power light glows when the Apple lie is turned on and normal 
power is present at the Apple He’s internal power supply. 

If the power light flashes on and off, turn off the computer immediately. 
Find out what caused the condition (such as a brownout or short circuit) 
and fix the problem before turning the computer on again. Above all, do 
not use the disk drive when the power light is flashing; this may damage 
the computer. 


1.1.2 The Speaker 

The red disk-use light glows whenever the built-in disk drive’s motor is 
switched on. The green power light glows when the Apple lie is turned on 
and normal power is present at the Apple lie’s internal power supply. 

The Apple lie has a speaker in the bottom of the case, as shown in Figure 
1-6. The speaker lets Apple lie programs produce a variety of sounds. There 
is also a volume control on the left side of the Apple lie case, and a jack for 
connecting headphones or an external speaker. The jack accepts either 
one-channel (monaural) or two-channel (stereo) plugs, although speaker 
output is monaural only. Inserting a plug disconnects the built-in speaker. 

Figure 1-6. Speaker, Volume Control, and Audio Output Jack 



Volume Control Knob 
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Audio Output Jack 
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1.1.3 The Built-in Disk Drive 


The Apple He’s built-in disk drive (Figure 1-7) is fully compatible with the 
Apple Disk lie® that reads and writes SM-inch single-sided 35-track disks. 
The drive door is on the right side of the Apple lie case. 


Figure 1-7. Built-in Disk Drive 



1.1.4 The Back Panel 

The back panel of the Apple lie (Figure 1-8) has seven connectors and a 

main power switch. From left to right they are 

□ a 9-pin D-type miniature connector for connecting hand controllers, a 
mouse, a joystick, or some other device (see Chapters 9 and 11) 

n a 5-pin DIN connector for serial input and output (port 2; normally for a 
modem) (see Chapters 7 and 11) 

□ a 15-pin D-type connector for video expansion (see Chapter 11) 

□ an RCA-type jack for a video monitor (see Chapter 1 1) 

□ a 19-pin D-type connector for connecting one or more external devices, 
such as intelligent disk drives (see Chapters 6 and 11) 

□ another 5-pin DIN connector for serial input and output (port 1; normally 
for a printer or plotter) (see Chapters 8 and 11) 

□ a special 7-pin DIN connector for power input (see Chapter 11) . 

Before attaching cables to the Apple lie back panel connectors, be sure to 

move the handle until it clicks into position for propping up the computer. 

The handle should be down whenever the computer is running so that it 

can maintain proper cooling airflow. 
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The installation manuals for external devices contain instructions for 
connecting them to the Apple lie. 


Figure 1-8. Back Panel Connectors 
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1.2 Inside of Machine 


Chapter 11 discusses in further detail these Figure 1-9 shows the main components inside the Apple lie computer, 
components and how they work. 


Figure 1-9. Inside of Machine 
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1.2.1 The Internal Voltage Converter 

The built-in voltage converter operates from a 12 to 15 VDC input source, 
such as provided by the external power supply furnished with the Apple lie 
(Figure 1-10). The voltage converter provides power for the logic board, 
built-in disk drive, one external disk drive, and the I/O signals available at 
the back panel. 
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Figure 1-10. Power Supply and Voltage Converter 



Internal 


Complete specifications of the Apple lie The voltage converter produces three different voltages: +5V, + 12V, and 
power supply and voltage converter appear _ i2V. (Minus 5V, needed by some components in the Apple lie, is derived 

in Chapter li. from — 12V on the main logic board.) It is a high-efficiency switching 

converter that protects itself and the rest of the Apple lie against short 
circuits and other electrical mishaps. 


1.2.2 The Main Logic Board 

The main logic board, which is mounted flat in the bottom of the Apple He’s 
case, has almost all the electronic parts of the computer attached to it. 


1.2 Inside of Machine 
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Firmware is program code that is stored in 
ROM. It can be read and executed, but not 
changed. 

The specifications of the 65C02 are given in 
Chapter 11; the 65C02 instruction set is 
given in Appendix A. 


Figure 1-11 shows the main logic board and the most important integrated 
circuits (ICs) in the Apple lie. They are the CPU (central processing unit), 
RAM (random-access memory), ROM (read-only memory) ICs for keyboard 
encoding, display character generation, and firmware, and the five custom 
integrated circuits. 

The processor is a 65C02 microprocessor. The 65C02 is a CMOS version of 
the 6502 used in other members of the Apple II family. It is an 8-bit 
microprocessor with a 16-bit address bus. In the Apple lie, the 65C02 runs at 
1 MHz and performs up to 500,000 8-bit operations per second. 


Figure 1-11. Main Logic Board 
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The Applesoft language interpreter is 
described in the Applesoft Tutorial and 
the Applesoft BASIC Programmer’s 
Reference Manual. 


Memory addressing: See Chapter 2. 
See Chapters 3 through 9. 


Chapter 11 discusses the functions of these 
integrated circuits in some detail. 


▲Warning 


The keyboard is scanned by an IC that generates matrix values for a ROM. 
The value of the ASCII code supplied by the ROM is latched at a specified 
memory location and is readable by programs. 

The character generator ROM converts ASCII character values to a form 
that the video display can use. 

The other ROM contains the Monitor, the Applesoft BASIC interpreter, 
enhanced video firmware, and other input/output firmware. The firmware 
that this ROM contains is described throughout this manual. 

Five of the large IC’s on the main logic board are custom-made for the 
Apple lie: 

□ The memory management unit (MMU) contains most of the logic that 
controls memory addressing in the Apple lie. 

□ The input/output unit (IOU) contains most of the logic that controls 
the built-in input and output features of the Apple lie. 

□ The timing generator (TMG) generates all the system and I/O clock 
and timing signals from a 14-MHz oscillator. 

□ The general logic unit (GLU) performs the remaining required logic 
functions. 

□ The disk controller unit, also known as the Integrated Woz 
Machine (IWM), is a single-chip version of the Apple Disk II controller 
card. It controls the built-in and external disk drives connected to the 
Apple lie. 


1.2.3 The Other Circuit Boards 


The Apple lie contains other circuit boards that serve special purposes: a 
motor-speed control and read/write logic board for the disk drive, and a 
matrix board for detecting the position of keys pressed. This manual does 
not discuss these circuit boards. 

Adjustment of disk drive speed must be done by an authorized Apple 
Service Center. Do not attempt to adjust the speed of your built-in disk 
drive. If you do, you may damage it and you will void your warranty. 


1.2 Inside of Machine 
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Each of the other registers holds eight bits 
(one byte), so the 65C02 is called an 8-bit 
processor. 


Appendix A lists the instructions the 65C02 
can carry out, their use, and their effects on 
the registers. For further information, 
consult the pertinent books listed in the 
Bibliography. 


This chapter introduces the Apple lie’s processor, the 65C02, and the 
memory ranges and locations in the Apple lie that have been set aside for 
special purposes. The last section of this chapter describes the reset 
routines, which restore the computer to a known state. 


2.1 The 65C02 Microprocessor 


The 65C02 is a general-purpose 8-bit CMOS microprocessor similar in 
operation to the 6502 used in other members of the Apple II family of 
computers. 

Figure 2-1 is a model of the 65C02 microprocessor’s register organization. 
Registers are fast-acting built-in storage areas where the processor performs 
and keeps track of its work. The 65C02 has one 16-bit register and five 8-bit 
registers. 

The 16-bit register is called the program counter (PC). It specifies the 
address in memory that contains the instruction the processor is currently 
carrying out. A 16-bit register can specify any one of 65,536 memory 
addresses, and so the 65C02 is said to have an address space of 65,536 
locations. 

The five 8-bit registers in the 65C02 are the following: 

□ The accumulator, or A register. The accumulator is like a desk top 
where the processor performs mathematical and logical operations on 
information. 

n The index registers, X and Y. The processor uses these registers to 
modify the address where information is to be found or placed, and to 
pass information from one program to another. 

□ A stack pointer, or S register. The processor uses a 256-byte region of 
memory— page $01— as an area to stack up bytes for future use. The 
stack is empty when the computer is turned on. Several 65C02 
instructions either push (store) the contents of a register onto the stack, 
or pull (retrieve) a byte from the stack and place it in a register. The 

S register keeps track of the address of the byte in the stack that is 
currently ready for use. 

□ A processor status register, called the P register. Seven of the eight 
bits of this register are used as flags to record the outcome of processor 
activities, and can be checked by later instructions to determine what 
has happened and what the processor should do next. 
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Figure 2-1. Internal Model of the 65C02 Microprocessor 

Copyright 1982, NCR Corporation . Used by permission of NCR Corporation, Dayton, Ohio. 
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2.2 Overview of the Address Space 


The Apple lie’s 65C02 microprocessor can address 65,536 (64K) memory 
locations. All the Apple He’s RAM, ROM, and input and output (I/O) devices 
are accessed using addresses in this 64K address range. Some functions 
have the same addresses— but not at the same time. The Apple lie controls 
Soft switches are described in Sections 2.4 its shared addresses by using soft switches. A soft switch is a memory 
and 2 - 5 - location that controls some aspect of the computer’s operation when it is 

accessed. 


There are two other ROMs in the Apple lie: 
one to generate characters corresponding to 
keystrokes (Section 11.7), and another to 
generate characters for display 
(Section 11.9). However, these ROMs are 
not addressable by the microprocessor. 


All input and output in the Apple lie is memory mapped— that is, specific 
memory addresses (all in the $C0 page) are allocated to each I/O device. In 
this chapter, the I/O memory spaces are described simply as areas of 
memory. For details of the built-in I/O features and firmware, refer to the 
descriptions in Chapters 3 through 9. 


A contiguous block of 256 address locations in the 65C02’s address range is 
called a page. A 1-byte address counter or 8-bit register can specify 1 of 
256 different locations. Thus, page $00 consists of memory locations from 
0 through 255 (hexadecimal $00 through $FF); page $01 consists of 
locations 256 through 511 (hexadecimal $0100 through $01FF); and so on. 

In this manual, all page numbers are given in hexadecimal format. 

Note: The first two digits of a four-digit hexadecimal address are the 
page number. There are 256 pages of 256 bytes each in the address space. 
This kind of page is different from the display areas in the Apple lie, 
which are sometimes referred to as Page 1 and Page 2. 


2.3 Memory Map and Memory Switching 


Figure 2-2 is a map of the Apple He’s memory address space and what the 
major blocks of addresses are used for. As you can see in the figure, 
addresses $C000 through $C0FF contain hardware only, and 
addresses $C100 through $CFFF contain ROM only. At all other addresses 
there are two to five blocks of RAM or ROM locations. At any given time, 
only one block of RAM or ROM occupies each set of addresses. As described 
later in this chapter, soft switches in the hardware page control which 
blocks the processor is currently using. 
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Figure 2-2. Apple He Memory Map 
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2.3.1 Main RAM Addresses 
($0000-$BFFF and $DOOO-$FFFF) 


The area labeled Main RAM in Figure 2-2 is so-called because some or all of 
it is present in all models of the Apple II series of computers. The Apple lie 
has 64K bytes of main RAM. 


2.3.2 Auxiliary RAM Addresses 
($0000-$BFFF and $D000-$FFFF) 


The Apple lie has 64K of auxiliary RAM built in. Some or all of that range of 
auxiliary memory is present in an Apple He with one of the 80-column text 
cards installed (see Appendix F), but there is no auxiliary RAM in the 
Apple II or II Plus. 

A range of addresses in auxiliary RAM cannot be used simultaneously with 
the same range of addresses in main RAM; your programs must use the soft 
switches described in this chapter to select either main or auxiliary memory 
for any given range of addresses. 


2.3.3 ROM Addresses ($C100-$FFFF) 

ROM addresses contain the built-in Apple lie firmware. Addresses $C100 
through $CFFF belong exclusively to ROM. Addresses $D000 through 
$FFFF are shared by ROM, main RAM, and auxiliary RAM; the selection 
techniques are described in Section 2.4.2. 

The Apple He’s built-in ROM pages $C1 through CF (addresses $C100 
through $CFFF) contain I/O firmware. The Apple lie I/O firmware is 
roughly divided among the built-in I/O devices as follows: 

□ Serial port 1 (RS-232 device) firmware entry points are on page $C1. 
Much, but not all, of the firmware for the port is in the SC100 space. 

□ Serial port 2 (communication device) firmware entry points are on 
page $C2. Much, but not all, of the firmware for the port is in the $0100 
space. 

□ Video output firmware entry points are on page $C3; the enhanced video 
firmware and miscellaneous I/O support routines occupy pages $C8 
through $CF. This is partly because there are no slots 8 through F on the 
Apple lie and because the firmware takes up more than one page of 
firmware memory space. 
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The operation of the Applesoft interpreter 
firmware is described in the Applesoft 
BASIC Programmer’s Reference 
Manual. 


□ Mouse firmware entry points are on page $C4. 

□ Disk I/O firmware entry points are on page $C6. 

Note: This correspondence of ports and entry points does not imply that 
all of each port’s firmware occupies a specific page. The Apple lie I/O 
port firmware space is allocated in a way that provides the best possible 
performance in the available space. 

The ROM address range of pages $D0 through $FF contain the Applesoft 

BASIC interpreter and the Monitor firmware, allocated as follows: 

□ Pages $D0 through $F7 (addresses $D000 through $F7FF) contain the 
Applesoft interpreter firmware. 

□ Pages $F8 through $FF (addresses $F800 through $FFFF) contain the 
Monitor, described in Chapter 10. You can use some of the built-in 
Monitor routines to make input and output procedures in your 
assembly-language programs easier to write. These routines are 
described in Chapters 3 through 9. 


Chapters 3 through 9 describe the 
Apple He’s input and output locations. 
Appendix B lists all of these locations in 
address order, rather than by function. 


Bit numbering in a byte is explained in 
Appendix H. 


2.3.4 Hardware Addresses ($COOO-$COFF) 

The soft switches that the Apple lie and your programs use to control the 
Apple He’s built-in input and output functions are all found in the SCO 
memory page (addresses SC000 through SCOFF). In the same range of 
memory are the switches for selecting blocks of memory throughout the 
address space. This chapter describes the address space (memory) 
switches. 

The hardware functions of the switches in this page fall into five basic 
categories: 

□ Data inputs. The only data input is location SC000, where the low-order 
seven bits (bits 6 through 0) represent the keyboard key just pressed. 
(These data are guaranteed valid only when bit 7 = 1. ) 

□ Flag inputs. Most built-in input locations are single-bit flags in the 
high-order (bit 7) position of their respective memory addresses. Flags 
have only two values: on (greater than or equal to 128 or $80) or off (less 
than 128 or $80). 

The switch, hand controller (analog) and button inputs, and the 
keyboard strobe are examples of flag inputs. The locations for reading 
soft-switch states are also of this type. 


2.3 Memory Map and Memory Switching 
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□ Strobe outputs. The clear keyboard strobe (Chapter 4) and paddle 
timer strobe (Chapter 9) outputs are controlled by memory locations. If 
your program reads the contents of one of these locations, then the 
function associated with that location will be activated. 

□ Toggle switches. The Apple lie has only one toggle switch: the speaker 
switch. A toggle switch has only one address assigned to it; each time 
you access it, it changes to its other state (on or off). 

Reading the speaker toggle at location $C030 clicks the speaker once. 
However, if you write to the speaker location, the microprocessor 
activates the address bus twice during successive clock cycles, causing 
the speaker toggle to end up in its original state before the speaker cone 
can move. Therefore, you should read, rather than write, to use this 
device. 

The processor cannot read the on/off status of the speaker switch. 

□ Soft switches. Soft switches are two-position switches turned on by 
accessing one address and turned off by accessing another address. Most 
of these switches have a third address associated with them for reading 
the state of the switch. 

There are eight soft switches that select different combinations of 
bank-switched memory (Section 2.4). Four of these eight switches 
require that your program read them twice in succession to activate 
them. 


2.4 Bank-Switched Memory 


The memory areas described in this section are called bank-switched 
memory (Figure 2-3) because so many banks (ranges) of addresses— one 
bank of ROM and up to four banks of RAM— occupy the same group of 
locations among the upper addresses of memory. Pages $00 and $01, at the 
low end of memory, are included here because the two sets of them— one in 
main RAM and one in auxiliary RAM— are controlled by the same switches 
as the high-address banks. The stack and zero page are switched this way 
so that system software running in the bank-switched memory space can 
maintain its own stack and zero page while it manipulates the 48K memory 
space (Section 2.5). 
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Figure 2-3. Bank-Switched Memory Map 
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2.4.1 Page Allocations 


All these memory banks are controlled by 
the soft switches described in Section 2.4.2. 


Pages $00 and $01 are used by many of the 65C02 instructions. The ROM 
and RAM addresses in bank-switched memory are usually occupied by 
system software such as interpreters, compilers, and operating systems. 

Page $00 (One-Byte Addresses) 

Several of the 65C02 microprocessor’s addressing modes— for example, 
indirect addressing— require the use of addresses in page $00, or zero page. 
However, the Monitor, the interpreters, and the operating systems all make 
extensive use of page $00, too. One way to avoid conflicts is to use only 
those page-$00 locations not already used by these other programs. But 
there is another way. 

As you can see from Table B-l in Appendix B, page $00 is pretty well used 
up, except for a few bytes here and there. Rather than trying to squeeze 
your data into an unused corner, you may prefer a safer alternative: turn off 
interrupts, save the contents of part of page $00, use that part, then restore 
the previous contents to page $00, restore interrupts to their previous state, 
and then pass control to another program. 

Page $01 (The 65C02 Stack) 

The 65C02 microprocessor uses page $01 as its stack— a place where it can 
store subroutine return addresses, in last-in, first-out sequence. Programs 
can also use the stack for temporary storage of registers (via push and pull 
instructions). However, programs should use the stack carefully. 

Pages $DO-$FF (ROM and RAM) 

The memory address space from locations $D000 through $FFFF is used for 
both ROM and RAM. The 12K bytes of ROM in this address space contain 
the Monitor and the Applesoft BASIC interpreter. 

There are 16K bytes of main RAM in this 12K space, with two banks 
occupying the 4K of addresses from $D000 through $DFFF. The RAM is 
normally used for storing other languages such as Pascal, or operating 
systems such as ProDOS™. 

There are also 16K bytes of auxiliary RAM in this 12K space, again with 
double occupancy in the address range $D000 through $DFFF. 
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2.4.2 Using Bank Selector Switches 


▲Warning 


Important! 


You switch banks of memory in the same way you switch other functions in 
the Apple lie: by using soft switches. These soft switches do four things: 

□ Select either RAM or ROM in this memory space. 

□ Allow or inhibit (write-protect) writing to the RAM when RAM is 
selected. 

□ Select the first or second 4K-byte bank of RAM in the address space 
$D000 through $DFFF. 

□ Select either main RAM or auxiliary RAM. 

Do not use soft switches without careful planning. Careless switching 
between RAM and ROM is almost certain to have catastrophic effects on 
your program. 

Table 2-1 shows the addresses of the soft switches for selecting all allowed 
combinations of reading and writing in this memory space, and the 
addresses of the locations to read the switch settings. Figures 2-4 
through 2-10 illustrate how to select the combinations and what the 
resulting status of each switch is. 

To make sure you do not inadvertently remove write protection from 
bank-switched RAM, the four write-enable addresses require that you read 
them twice in succession (indicated by RR in Table 2-1). 

Because the AltZP switch shares the read keyboard address, you must write 
(W in Table 2-1) to its locations to change the switch setting. 

To find out which way a switch is set, read the appropriate location and 
then check bit 7 (shown as R7 in Table 2-1). If the bit is a 1, the answer to 
the question given in the table is affirmative. 

Note that there is no way to check whether write protection is on or off. 

You can’t read one RAM bank and write to the other; if you select either 
RAM bank for reading, you get that one for writing as well. However, you 
can read ROM and write RAM (Figures 2-5 and 2-6), which makes it easy 
to transfer firmware to bank-switched RAM if you want to use it with a 
program there. 


2.4 Bank-Switched Memory 
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Table 2-1. Bank Selector Switches 


Name 

Action 

Hex 

Dec 

Function 


R 

$C080 

49280 

Read RAM; no write; use $D000 
bank 2 


RR 

$C081 

49281 

Read ROM; write RAM; use $D000 
bank 2 


R 

$C082 

49282 

Read ROM; no write; use $D000 
bank 2 


RR 

$C083 

49283 

Read and write RAM; use $D000 
bank 2 


R 

$0088 

49288 

Read RAM; no write; use $D000 
bank 1 


RR 

$0089 

49289 

Read ROM; write RAM; use $D000 
bank 1 


R 

$C08A 

49290 

Read ROM; no write; use $D000 
bank 1 


RR 

$C08B 

49291 

Read and write RAM; use $D000 
bank 1 

RdBnk2 

R7 

$0011 

49169 

Read whether $D000 bank 2 (1) or 
bank 1 (0) 

RdLCRAM 

R7 

$0012 

49170 

Read RAM (1) or ROM (0) 

AltZP 

W 

$0008 

49160 

Off: Use main bank, page $00 and 
page $01 

AltZP 

W 

$0009 

49161 

On: Use auxiliary bank, page $00 
and page $01 

RdAltZP 

R7 

$0016 

49174 

Read whether auxiliary (1) or 
main (0) bank 
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Figure 24. Read ROM 
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Figure2-5. Read ROM, Write RAM, and Use First $D0 Bank 
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Figure 2-6. Read ROM, Write RAM, and Use Second $D0 Bank 
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Figure 2-7. Read RAM and Use First $D0 Bank 
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Figure 2-8. Read RAM and Use Second $D0 Bank 
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Figure 2-9. Read and Write RAM and Use First $D0 Bank 
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Figure 2-10. Read and Write RAM and Use Second $D0 Bank 
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Important! 


A buffer is any storage area set aside for 
one program or device to put information 
into and another to take information out of 
at a different time or rate. 


Refer to Appendix D and to the appropriate 
programmer and reference manuals for 
operating system use of page $03. 


Global storage refers to an area reserved 
for information that programs use in 
common. Vectors— the addresses of 
special routines— are examples of this kind 
of information. Section 2.6 discusses the 
global storage and vectors found on 
page $03. 


2.5 48K Memory 


The 48K memory space (actually, 47I4K) extends from location $0200 to 
location $BFFF (Figure 2-11) in both main and auxiliary RAM. The amount 
of storage available in this address space depends on what language or 
operating system you are using, and what video display needs your program 
has. 


2.5.1 Page Allocations 


Most of the Apple lie’s 48K RAM is available for storing your programs and 
data. However, a few RAM pages are reserved for the use of the Monitor 
firmware, the Applesoft BASIC interpreter, and whatever video display you 
may select. 

The system does not prevent your using these pages, but if you do use 
them, you must be careful not to disturb the system data they contain. 

Page $02 (The Input Buffer) 

The GetLn input routine (Section 3.2.3) uses page $02 as its keyboard-input 
buffer. The size of this buffer (256 bytes) sets the maximum size of input 
strings read by Applesoft or the Monitor. If you know that you won’t be 
typing any long input strings (more than, say, 30 characters), you can store 
temporary data at the upper end of page $02. 

Page $03 (Global Storage and Vectors) 

The Monitor and operating systems use parts of page $03 for global storage 
and vectors. Table 2-7, later in this chapter, shows the part of page $03 the 
built-in firmware uses. 

Pages $04-$07 (Text and Low-Resolution Page 1) 

The most often used display buffer is the text and low-resolution graphics 
Page 1 (TLP1 in Figure 2-11), which occupies main memory pages $04 
through $07. It is not usable for program and data storage if you are using 
Monitor routines or Applesoft, or with almost any other program that uses 
text or low-resolution display. 
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48K RAM 


Figure 2-11. 48K Memory Map 
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See Chapter 5. 


See Section 3.4.6. 


Serial port 2: See Chapter 8. 


See Chapter 5. 


Text and low-resolution Page IX (TLP1X) is an identical display page 
occupying auxiliary memory pages $04 through $07. This pair of text and 
low-resolution graphics pages are used together to produce 80-column text 
display. 

There are 128 locations in pages $04 through $07 (64 in main RAM, 64 in 
auxiliary RAM) that are not displayed on the screen. These locations are 
called screen holes. 

▲Warning I The screen holes are reserved for use by the built-in firmware. 

Pages $08-$0B (Text and Low-Resolution Page 2) 

The second text and low-resolution graphics display buffer, TLP2, occupies 
main memory pages $08 through $0B. Most programs do not use Page 2 for 
displays, but TLP2 is there for display use if required. 

Text and low-resolution Page 2X (TLP2X) is an identical display buffer 
occupying pages $08 through $0B in auxiliary memory. 

Note that Apple lie firmware does not provide a way to use the second pair 
of text and low-resolution graphics pages for 80-column text display. 

Page $08 (Communication Port Buffers) 

Serial port 2 uses the first half of auxiliary memory page $08 (addresses 
$0800 through $087F) as a keyboard input buffer, and the second half of the 
page (addresses $0880 through $08FF) as a serial input buffer. These 
buffers increase the data transfer rates possible with the serial 
communication port. Appendix E explains how to use these features. 

If your program does not use this page for buffers, it can use it as part 
of TLP2X. 


Pages $20-$3F (High-Resolution Page 1) 

The primary high-resolution graphics display buffer, called high-resolution 
Page 1 (HRP1), occupies the 32 memory pages from $20 through $3F 
(locations $2000 through $3FFF). If your program doesn’t use 
high-resolution graphics, this area is usable for programs or data. 

High-resolution Page IX (HRP1X) is an identical display page occupying 
auxiliary memory pages $20 through $3F. 

The Apple lie can display double-high-resolution graphics by interleaving 
HRP1 and HRP1X. 
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For more information about the display 
buffers, see Chapter 5. 


For details, refer to Section 2.5.4. 


Pages $40-$5F (High-Resolution Page 2) 

High-resolution Page 2 occupies main memory pages $40 through $5F 
(locations $4000 through $5FFF). Most programs use this area for program 
or data storage, but it is also available as a second high-resolution page. 

High-resolution Page 2X (HRP2X) occupies auxiliary memory pages $40 
through $5F. 

Apple lie firmware provides high-resolution graphics routines for HRP1 and 
HRP2 only. Refer to the Applesoft BASIC Programmer’s Reference 
Manual. 


2.5.2 Using 48K Memory Switches 

Two switches select main or auxiliary RAM in the 48K memory space: 
RAMRd determines which to use for reading, and RAMWrt determines 
which to use for writing. When these switches are on, they select auxiliary 
memory. When they are off, they select main memory. (This discussion 
assumes that the 80Store switch, used to control display memory, is off.) 

Each switch has three locations assigned to it (Table 2-2): one to turn it on, 
one to turn it off, and a third to read its state. Because the memory locations 
for turning the switches on and off are shared with keyboard reading 
functions, you must write to these addresses to use them for memory 
switching. For each switch, you can read bit 7 at its third location to check 
whether the switch is on or off. If the switch is on, bit 7 is 1; if the switch is 
off, bit 7 is 0. Figures 2-12 and 2-13 illustrate how the switches work. 


Table 2-2. 48K Memory Switches 

Note: 80Store must be off to switch all memory in this range, including display 
memory (Table 2-6). 

Name Action Hex Dec Function 


RAMRd 

w 

$C002 

49154 

RAMRd 

w 

$C003 

49155 

RdRAMRd 

R7 

$C013 

49171 

RAMWrt 

W 

$C004 

49156 

RAMWrt 

W 

$C005 

49157 

RdRAMWrt 

R7 

$C014 

49172 


2.5 48K Memory 


Off: Read main 48K RAM 
On: Read auxiliary 48K RAM 
Read whether main (0) or aux. (1) 

Off: Write to main 48K RAM 
On: Write to auxiliary 48K RAM 
Read whether main (0) or aux. (1) 
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Figure 2-13. 48K RAM Selection: One Side Only 
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2.5.3 Transfers Between Main and Auxiliary Memory 


Important! 


▲Warning 


If you want to write assembly-language programs that use auxiliary 
memory but you don’t want to manage the auxiliary memory yourself, you 
can use the built-in 48K RAM transfer routines. These routines (listed in 
Table 2-3) make it possible to move between main and auxiliary memory 
without having to manipulate the soft switches described in Section 2.5.2. 

The routines described below make it easier to use auxiliary memory, but 
they do not protect you from errors. You still have to plan your use of 
auxiliary memory to avoid catastrophic effects on your program. 

Table 2-3. 48K RAM Transfer Routines 


Name 

Action 

Hex 

Function 

MoveAux 

JSR 

SC311 

Move data blocks between main and auxiliary 
48K memory 

XFer 

JMP 

$C314 

Transfer program control between main and 
auxiliary 48K memory 


Transferring Data 

In your assembly-language programs, you can use the built-in routine 
named MoveAux to copy blocks of data from main memory to auxiliary 
memory or from auxiliary memory to main memory. Before calling this 
routine, you must put the data addresses into byte pairs in page $00 and set 
or clear the carry bit to select the direction of the move. 

Don’t try to use MoveAux to copy data in bank-switched memory (page 
$00, page $01, or pages $D0 through $FF). MoveAux uses page $00 all 
during the copy. 

The pairs of bytes you use for passing addresses to this routine are 
called Al, A2, and A4, and they are used for parameter passing by several of 
the Apple He’s built-in routines. The addresses of these byte pairs are 
shown in Table 2-4. 

Put the addresses of the first and last bytes of the block of memory you 
want to copy into Al and A2. Put the starting address of the block of 
memory you want to copy the data to into A4. 


40 


Chapter 2: Memory Organization and Control 


Table 2-4. Parameters for MoveAux Routine 


Name 

Location 

Parameter Passed 

Carry 


1 = Move from main to auxiliary memory 

0 = Move from auxiliary to main memory 

AIL 

$3C 

Source starting address, low-order byte 

A1H 

$3D 

Source starting address, high-order byte 

A2L 

$3E 

Source ending address, low-order byte 

A2H 

$3F 

Source ending address, high-order byte 

A4L 

$42 

Destination starting address, low-order byte 

A4H 

$43 

Destination starting address, high-order byte 


X, Y, A 

These registers are preserved. 


The MoveAux routine uses the carry bit to select the direction to copy the 
data. To copy data from main memory to auxiliary memory, set the carry bit 
(SEC instruction); to copy data from auxiliary memory to main memory, 
clear the carry bit (CLC instruction). 

When you make the subroutine call to MoveAux, the subroutine copies the 
block of data as specified by the A register and the carry bit. When it is 
finished, the accumulator and the X and Y registers are just as they were 
when you called it. 

Transferring Control 

You can use the built-in routine named XFer to transfer control to and from 
program segments in auxiliary memory. You must set up three parameters 
before using XFer: the address of the routine you are transferring to, the 
direction of the transfer, and which page $00 and stack you want to use 
(Table 2-5). 
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Table 2-5. Parameters for XFer Routine 


▲Warning 


Name 

Location 

Parameter Passed 

Carry 


1 = Transfer from main to auxiliary memory 

0 = Transfer from auxiliary to main memory 

Overflow 


1 = Use page $00 and stack in auxiliary memory 
0 = Use page $00 and stack in main memory 


$03ED 

$03EE 

Program starting address, low-order byte 
Program starting address, high-order byte 


X, Y, A 

These registers are preserved. 


Put the transfer address into the two bytes at locations $03ED and $03EE, 
with the low-order byte first, as usual. The direction of the transfer is 
controlled by the carry bit: set the carry bit to transfer to a program in 
auxiliary memory; clear the carry bit to transfer to a program in main 
memory. 

Use the overflow bit to select which page $00 and stack you want to use: 
clear the overflow bit to use the main memory; set the overflow bit (cause 
an overflow condition) to use the auxiliary memory. 

After you have set up the parameters, pass control to the XFer routine by a 
jump instruction, rather than a subroutine call. 

It is your responsibility as the programmer to save the current stack 
pointer before using XFer and to restore it after regaining control. Failure 
to do so will cause program errors. Refer to Appendix E for instructions on 
how to do this. 
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2.5.4 Using Display Memory Switches 


Section 2.5.2 discusses how to select main or auxiliary RAM for the 
48K memory space. However, under many circumstances your program 
may want to control reading and writing to display pages separately. The 
switches discussed in this section override the effects of RAMRd and 
RAMWrt for display pages only. 

Three switches are involved in the display page selection process. Each of 
them has three locations assigned to it: one to turn it on, one to turn it off, 
and a third to read its state (Table 2-6). One of the switches, 80Store, shares 
its on and off addresses with a keyboard reading function. As a result, your 
program must write to these locations to turn the switch on and off. 


Table 2-6. Display Memory Switches 


Name 

Action 

Hex 

Dec 

Function 

80Store 

W 

$cooo 

49152 

Off: RAMRd and RAMWrt 
determine RAM locations. 

See Chapter 5 for a discussion of display 80Store 

pages. 

W 

$C001 

49153 

On: Page2 switches between TLP1 
and TLP1X, and (if HiRes on) 
between HRP1 and HRP1X. 

Rd80Store 

R7 

$C018 

49176 

Read whether 80Store on (1) or off 
(0) 

Page2 

R 

$C054 

49236 

Off: Select TLP1 and HRP1 

Page2 

R 

$C055 

49237 

On: If 80Store off, switch to TLP2, 
and (if HiRes on) to HRP2. If 

80Store on, switch to TLP1X, and 
(if HiRes on) to HRP1X. 

RdPage2 

R7 

$C01C 

49180 

Read whether Page2 on (1) or 
off (0) 

HiRes 

R 

$C056 

49238 

Off: Display text and low-resolution 
page 

HiRes 

► 

R 

$C057 

49239 

On: Display high-resolution pages; 
make Page2 switch between 
high-resolution pages 

RdHiRes 

R7 

$C01D 

49181 

Read whether HiRes on (1) or 
off (0) 
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Table 2-6 — continued. Display Memory Switches 


Name 

Action 

Hex 

Dec 

Function 

IOUDis 

W 

$C07E 

49278 

On: Disable 10U access for 
addresses $0058 to $C05F; enable 
access to DHiRes switch* 

IOUDis 

W 

$C07F 

49279 

Off: Enable IOU access for 
addresses $0058 to $C05F; disable 
access to DHiRes switch* 

RdlOUDis 

R7 

$C07E 

49278 

Read IOUDis switch (l=off)t 

DHiRes 

R/W 

$C05E 

49246 

On: (If IOUDis on) turn on 
double-high resolution 

DHiRes 

R/W 

$C05F 

49247 

Off: (If IOUDis on) turn off 
double-high resolution 

RdDHiRes 

R7 

$C07F 

49279 

Read DHiRes switch (l=on)t 


* The firmware normally leaves IOUDis on. 

t Reading or writing any address in the range $CO70-$CO7F also triggers the paddle timer 
and resets VBlInt (see Chapter 9). 


For each switch, you can read bit 7 at its third location to check whether 
the switch is on or off. If the switch is on, bit 7 is 1; if the switch is off, bit 7 
isO. 

Here is how these switches work for reading and writing: 

□ If HiRes is off, then Page2 switches between text and low-resolution 
graphics pages (TLP) only. If HiRes is on, then Page2 switches between 
TLP and high-resolution graphics pages (HRP). 

□ If 80Store is off, RAMRd and RAMWrt (Table 2-2) determine whether 
main or auxiliary RAM locations are used. Page2 selects pages for display 
(Chapter 5), but not for reading and writing. 

□ If 80Store is on, it overrides RAMRd and RAMWrt with respect to the 
display pages selected by HiRes and Page2 (Figures 2-14 and 2-15). 
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Figure 2-14. Page2 Selections With 80Store On and HiRes Off 
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Figure 2-15. Page2 Selections With 80Store On and HiRes On 
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2.6 The Reset Routine 


A procedure called the reset routine (Figure 2-16) puts the Apple lie into a 
known state when it has just been turned on or when you hold down 
I control | while pressing | reset ] . The reset routine puts the Apple lie into 
its normal operating mode and restarts the program indicated at 
locations $03F2 and $03F3 (Table 2-7). 

When you initiate a reset, hardware in the Apple lie sets the 
memory-controlling soft switches to normal: main ROM and RAM are 
enabled, auxiliary RAM is disabled and the bank-switched memory space is 
set up to read from ROM and write to RAM, using the second bank at $D000. 


Figure 2-16. Reset Routine Flowchart 
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Table 2-7. Page $03 Vectors 


The reset vector validity check is described 
in Section 2.6.4. 


Vector Address 

Vector Function 

$03F0 (1008) 
$03F1 (1009) 

Address of the subroutine that handles BRK requests 
(normally $59, $FA) 

$03F2 (1010) 
$03F3 (1011) 

Reset vector (see text) 

$03F4 (1012) 

Power-up byte (see text) 

$03F5 (1013) 
S03F6 (1014) 
S03F7 (1015) 

Jump instruction to the subroutine that handles Applesoft 
&-commands (normally $4C, $58, $FF) 

S03F8 (1016) 
$03F9 (1017) 
$03FA (1018) 

Jump instruction to the subroutine that handles user 
CONTROL-Y commands 

$03FB (1019) 
$03FC (1020) 
$03FD (1021) 

Jump instruction to the subroutine that handles 
nonmaskable interrupts (not used on Apple lie) 

$03FE (1022) 
$03FF (1023) 

Interrupt vector (address of the subroutine that handles 
interrupt requests) (Appendix E) 

The reset routine sets the display-controlling soft switches to display 
40-column text Page 1 using the primary character set, then sets the display 
window equal to the full 40-column display, puts the cursor at the bottom of 
the screen, and sets the text display format to normal. 


The reset routine also sets the keyboard and display as the standard input 
and output devices (Chapter 3). It masks mouse interrupts and sets mouse 
defaults (Table 9-1). Finally, it enables DHiRes switch access (by turning on 
IOUDis), clears the keyboard strobe, and sounds the speaker. 


The Apple lie has three types of reset: power-on reset, also called cold-start 
reset; warm-start reset; and forced cold-start reset. The procedure described 
above is the same for any type of reset. What happens next depends on the 
reset vector. The reset routine checks the reset vector to determine whether 
it is valid or not. If the reset was caused by turning the power on, the vector 
will not be valid, and the reset routine will perform the cold-start procedure. 
If the vector is valid, the routine will perform the warm-start procedure. 
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2.6.1 The Cold-Start Procedure (Power On) 


If the reset vector is not valid, either the Apple lie has just been turned on 
or something has caused memory contents to be changed. The reset routine 
clears the display and puts the string Apple© 1 1 c at the top of the 
display. It loads the reset vector and the validity-check byte, then initiates 
the startup routine that resides in the disk controller firmware. The 
bootstrap routine then loads whatever operating system resides on the disk 
in the built-in drive. When the operating system has been loaded, it displays 
other messages on the screen. If there is no disk in the disk drive, the drive 
motor keeps spinning for a brief time. Then the firmware shuts it off and 
displays the message Check Disk Drive at the bottom of the screen. 

If you press | control h reset | again before the startup procedure is 
completed, the reset routine continues without using the disk, and passes 
control to the Applesoft BASIC interpreter. 


2.6.2 The Warm-Start Procedure (CONTROL-RESET) 

Whenever you press | control H reset | when the Apple lie has already 
completed a cold-start reset, the reset vector is still valid and it is not 
necessary to reinitialize the entire system. The reset routine simply uses the 
vector to transfer control to the program it points to, which at power-up is 
the Applesoft interpreter. 

If the vector does point to the Applesoft interpreter, your Applesoft program 
and variables are still intact. If you are using DOS or ProDOS, that operating 
system is the resident program and it restarts the BASIC interpreter you 
were using when you pressed | control H reset | . 


Important! 


A program residing only in bank-switched RAM cannot use the reset 
vector to regain control after a reset, because upon reset the hardware 
selects the ROM for reading in the bank-switched memory space. 


2.6.3 Forced Cold Start (OPEN APPLE-CONTROL-RESET) 

If a program has set the reset vector to point to its own warm-start address, 
as described below, pressing | control H reset | causes transfer of control 
to that program. If you want to stop such a program without turning the 
power off and on, you can force a cold-start reset by holding down 
I control | and [5], then pressing and releasing I reset | . 


2.6 The Reset Routine 
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Important! 


When you want to stop a program unconditionally— for example, to start 
up the Apple lie with some other program— you should use the forced 
cold-start reset, [cTH control H reset |, instead of turning the power off 
and on. 


UniDisk 3.5 


You must hold [5] down until the built-in drive starts to spin. If you 
release [a) before the drive starts to spin, the Apple lie drops into BASIC 
instead of rebooting. 


The forced cold-start reset works as follows. First, it destroys the program 
or data in memory by writing two bytes of arbitrary data into each page of 
main RAM. The two bytes that get written over in page $03 are the ones 
that contain the reset vector. The warm-start reset routine finds the error, 
and so performs a normal cold-start reset. 


Note that if you press both [6] and [1] during power-up or 
I control tf reset |, built-in exercise code is executed. This code is for 
production and has no end-user value. 


2.6.4 The Reset Vector 


The cold-start reset routine stores the starting address of the built-in 
Applesoft interpreter, low-order byte first, in the reset vector address at 
locations $03F2 and $03F3. It then stores a validity-check byte, also called 
the power-up byte, at location $03F4. The validity-check byte is computed 
by performing an exclusive-OR of the second byte of the vector with the 
constant 165 (hexadecimal $A5). Each time you reset the Apple lie, the 
reset routine uses this byte to determine whether the reset vector is still 
valid. 

You can change the reset vector so that the reset routine will transfer 
control to your program instead of to the Applesoft interpreter. For this to 
work, you must also change the validity-check byte to the exclusive-OR of 
the high-order byte of your new reset vector with the constant 165 ($A5). If 
you fail to do this, then the next time you reset the Apple lie, the reset 
routine will determine that the reset vector is invalid and perform a 
cold-start reset, eventually transferring control to the disk bootstrap routine 
or to Applesoft. 

There is a subroutine that generates the validity-check byte for the current 
reset vector. This subroutine, called SetPWRC, is at location $FB6F. When 
your program finishes, it can return the Apple lie to normal operation by 
restoring the original reset vector and again calling the subroutine to fix up 
the validity-check byte. 
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Chapter 3 


Introduction to Apple lie I/O 
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This chapter is an introduction to the built-in I/O capabilities of the 
Apple lie. It outlines 

□ standard I/O links and their functions 

□ I/O firmware protocols 

□ dedicated memory storage locations 

□ direct I/O. 

The next six chapters discuss these capabilities in detail. 


3.1 The Standard I/O Links 


You can use some of the routines in the Apple He’s firmware for your own 
programs. This can save you both program space and the time and effort of 
writing all your own I/O routines. 

To use the built-in firmware routines, your program must perform a JSR to 
the routine’s entry address. The called routine then performs an indirect 
jump through an address stored somewhere in RAM and begins executing. 
When the routine has finished doing its work, it returns (with an RTS) to 
your program at the first instruction following the JSR used to call the 
routine. Memory locations used for transferring control to other subroutines, 
such as the indirect jump’s address used by the character I/O routine, are 
sometimes called vectors. In this manual, the locations used for transferring 
control to the Apple He’s I/O subroutines are called the I/O links. 

In an Apple lie running without an operating system, each I/O link 
normally contains the address of the standard input or output subroutine. 
An operating system will typically place addresses of its own I/O routines 
in these link locations instead. 

By calling the I/O subroutines that then jump to the routines pointed to by 
the link addresses instead of calling the standard subroutines directly, you 
ensure that your program will work properly with other software, such as 
the operating system or a device driver. The I/O links contain the addresses 
of Keyln and COutl if the enhanced video firmware is off (when the display 
shows a flashing checkerboard cursor), and of C3KeyIn and C3COutl if that 
firmware is on (when the display shows an inverse solid cursor). 

The standard I/O links are two pairs of locations in the Apple lie RAM in 
the range $36 through $39 that are used for controlling character input and 
output. 
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The Monitor is discussed in Chapter 10. 


▲Warning 


Note: Not all operating systems use the standard I/O links. For example, 
Apple Pascal does not use them. 

The link at locations $36 and $37 is called CSW, for character output 
switch. Individually, location $36 is called CSWL (CSW low) and 
location $37 is called CSWH (CSW high). This link holds the starting 
address of the subroutine the Apple lie is currently using for 
single-character output. This address is normally $FDF0, the address of 
routine COutl. 

When you issue either a PR#n from BASIC or an n CONTROL-P from the 
Monitor, the Apple lie changes this link address to the first address in the 
ROM space allocated to port n. That address has the form $Cn00. 
Subsequent calls for character output are thus transferred to the firmware 
starting at that address. When it has finished, the firmware executes an 
RTS (return from subroutine) instruction to return control to the calling 
program. Sometimes a PR#n will cause both input and output switches to 
be changed (as in the 80-column firmware). 

A similar link at locations $38 and $39 is called KSW, for keyboard input 
switch. Individually, location $38 is called KSWL (for KSW low) and 
location $39 is called KSWH (KSW high). This link holds the starting 
address of the routine currently being used for single-character input— 
normally $FD1B, the starting address of the standard input routine Keyln. 

When you issue an IN#n command from BASIC or an n CONTROL-K from 
the Monitor, the Apple lie changes the link address in KSW to $Cn00, the 
beginning of an I/O firmware subroutine. Subsequent calls for character 
input are thus transferred to that firmware. The firmware puts the input 
character, with its high bit set, into the accumulator and executes an RTS 
(return from subroutine) instruction to return control to the program that 
requested input. 

When a disk operating system (DOS or ProDOS) is running, one or both of 
the standard I/O links hold addresses of the disk operating system’s input 
and output routines. The operating system has internal locations that hold 
the addresses of the currently active character input and output routines. 

If a program that is running with DOS or ProDOS changes the standard 
link addresses, either directly or via IN# and PR# commands, the 
operating system may be disconnected from the system. To avoid this 
problem, when programming in BASIC you should always issue an empty 
PRINT statement (to be sure that what follows begins a new line) before 
issuing the PRINT statement containing CONTROL-D and the IN# or PR# 
command. 


3.1 The Standard I/O Links 
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Refer to the section on input and output 
link addresses in the operating system 
manuals for further details. 


After changing either CSW or KSW, your assembly-language programs 
running under DOS should call the subroutine at location $03EA. This 
subroutine transfers the link address to a location inside the operating 
system and then restores the operating system link address in the standard 
link location. 


GetLn also provides on-screen editing 
features: See Section 3.2.5. 


3.2 Standard Input Features 


The Apple He’s firmware includes two different subroutines for reading 
from the keyboard, RdKey (for read key) and GetLn (get line). 

RdKey calls the current character input routine (that is, the one whose 
address is stored at KSW). This is normally Keyln or C3KeyIn, which 
accepts one character from the keyboard. GetLn accepts a sequence of 
characters terminated with a carriage return. Thus GetLn allows 
line-oriented input using the current input routine. 


3.2.1 RdKey Subroutine 

A program can get a character from the keyboard by making a subroutine 
call to RdKey at memory location $FD0C. RdKey passes control via the 
input link KSW to the current input subroutine, which is normally Keyln. 

RdKey displays a cursor at the current cursor position, which is 
immediately to the right of whatever character you last sent to the display 
(normally by using the COut routine, described below). 


3.2.2 Keyln Subroutine 

Keyln is the standard input subroutine. When your program calls it, Keyln 
displays a cursor, waits until someone presses a key, then inserts the ASCII 
code of the key just pressed in the accumulator and returns to the calling 
program. 

If the enhanced video firmware is inactive, Keyln displays a cursor by 
alternately storing a checkerboard block in the cursor location, storing the 
original character, then storing the checkerboard again. If the firmware is 
active, C3KeyIn places a block cursor on the screen by inverting (swapping 
black for white) the character at the cursor position. 
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Section 3.2.5 describes other features of 
GetLn. 


Keyln also generates a random number. While it is waiting for the user to 
press a key, Keyln repeatedly increments the 16-bit number in memory 
locations $4E and $4F. This number keeps increasing from 0 to $FFFF 
(65535), then starts over again at 0. The value of this number changes so 
rapidly that it is very difficult to predict what it will be after a key is 
pressed. A program that reads from the keyboard can use this value as a 
random number or as a seed for a pseudo-random number routine. 


3.2.3 GetLn Subroutine 

Programs often need strings of characters as input. While you could call 
RdKey repeatedly to get several characters from the keyboard, there is an 
easier way to do it. The routine that you want to use in this case is named 
GetLn, and it starts at location $FD6A. Using repeated calls to RdKey, 

GetLn accepts characters from the standard input subroutine — usually 
Keyln— and puts them into the input buffer located in the memory page 
from $0200 to $02FF. GetLn also provides you with some basic on-screen 
editing and control features. 

The first thing GetLn does when you call it is to display a prompt. The 
prompt indicates to the user that the program is waiting for input. Different 
programs use different prompt characters, helping to remind the user which 
program is requesting the input. Table 3-1 shows the prompt characters 
used by different programs on the Apple lie. 

GetLn uses the character stored at memory location $33 as the prompt 
character. In an assembly-language program, you can change the prompt to 
any character you wish. In BASIC, changing the prompt character has no 
effect, because both BASIC interpreters and the Monitor restore it each time 
they request input from the user. 


Table 3-1. Prompt Characters 

Prompt 

Character Program Requesting Input 

? User’s BASIC program (INPUT statement) 

] Applesoft BASIC (Appendix D) 

> Integer BASIC (Appendix D) 

* Firmware Monitor (Chapter 10) 


3.2 Standard Input Features 
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Note: Applesoft uses GetLnl ($FD6F) when a program is executing. 
GetLnl does not print a prompt. 

As the user types each character, GetLn sends the character to the standard 
output routine — normally COutl — which displays it at the current cursor 
position and then advances the cursor to indicate the next character 
position. Control characters echoed by GetLn are not executed. 

GetLn stores the characters in its buffer, starting at memory location $0200 
and using the X register to index the buffer. GetLn continues to accept and 
display characters until the user presses | return I (or | control H~x1 to 
cancel the line). Then it clears the remainder of the line the cursor is on, 
stores the carriage-return code to mark the end of the buffer, places the 
cursor at the beginning of the next line, and returns. 

The maximum line-length that GetLn can handle is 255 characters. If the 
user types more than this, GetLn sends a backslash (\) and a carriage 
return to the display, cancels the line it has accepted so far, and starts over. 
To warn the user that the line is getting full, GetLn sounds a bell (tone) at 
every keypress after the 248th. 

I Note: The Applesoft interpreter accepts only 239 characters. 


3.2.4 Escape Codes With GetLn 


Important! 


GetLn has many special functions that you invoke by typing escape codes 
on the keyboard. An escape code is sent by pressing fijcl, releasing it, and 
then pressing some other key, as shown in Table 3-2. 

Be sure to release I esc I right away. If you hold it too long, the auto-repeat 
mechanism begins, which may cancel the | esc | . 


Table 3-2. Escape Codes With GetLn 


Escape Code Function 


I esc 1 1~@1 Clears the window and homes the cursor (places it 

in the upper-left corner of the screen), then exits 
from escape mode 

I esc | [a] Moves the cursor right one line and exits from 

or | esc | [a] escape mode 


fisci m 

or fEsci nn 


Moves the cursor left one line and exits from 
escape mode 
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Table 3-2— continued. Escape Codes With GetLn 


Escape Code 

Function 

1 ESC || C| 

or | esc 1 1 cl 

Moves the cursor down one line and exits from 
escape mode 

1 ESC 1 1 D | 
or | ESC 1 1 d | 

Moves the cursor up one line; exits from escape 
mode 

rESClfEl 

Or | ESC 1 1 e | 

Clears to the end of the line; exits from escape 
mode 

1 ESC 1 1 F | 

or | esc 1 1 f | 

Clears to the bottom of the window; exits from 
escape mode 

iesciiti 

or | ESC II i 1 
or | esc || 1 1 

Moves the cursor up one line; remains in escape 
mode* 

nscim 
oriEscim 
or iesciI^I 

Moves the cursor left one space; remains in escape 
mode* 

rESClfKl 
or | ESC 1 1 k | 
or | esc if^i 

Moves the cursor right one space; remains in 
escape mode* 

1 ESC 11 Ml 

Or 1 ESC 1 1 m | 

or | esc | M | 

Moves the cursor down one line; remains in escape 
mode* 

1 ESC || 4 | 

1 ESC ||8| 

I ESC || CONTROL |-| D | 

Switches to 40-column mode; sets links to 

C3KeyIn and C3COutl; restores normal window 
size (Table 3-5); exits from escape modet 

Switches to 80-column mode; sets links to 

C3KeyIn and C3COutl; restores normal window 
size (Table 3-5); exits from escape modet 

Disables control characters; only carriage return, 
line feed, bell, and backspace have an effect when 
printed 

[Tscll CONTROL HT| 

Reactivates control characters 

fESCl I CONTROL |-fol 

Deactivates the enhanced video firmware; sets 
links to Keyln and COutl; restores normal window 


size (Table 3-5); exits from escape modet 

* Cursor-control key: see text. 

t This code functions only when the enhanced video firmware is active. 
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For an introduction to editing with these 
features, refer to the Applesoft Tutorial. 


In escape mode, you can keep using the arrow keys and the cursor 
movement keys (T), [7)> [k], and [m] without pressing [~esc~1 again. This 
enables you to perform repeated cursor moves by holding down the 
appropriate key. 

When GetLn is in escape mode, it displays an inverse plus sign as the 
cursor. You leave escape mode by typing any key other than a cursor 
movement key. 

Note: The escape codes with the arrow keys are the standard cursor 
movement keys on the Apple lie. The escape codes with Q], [7], [k], 
and [m] are the standard cursor movement keys on the Apple II and 
II Plus, and are present on the Apple lie for compatability. 

Escape sequences can be used in the middle of an input line to change the 
appearance of the screen. They have no effect on the input line. 


3.2.5 Editing With GetLn 

Subroutine GetLn provides the standard on-screen editing features used by 
the BASIC interpreters and the Monitor. Any program that uses GetLn for 
reading the keyboard has these features. 

Cancel Line 

Anytime you are typing a line, pressing | control h fxl causes GetLn to 
cancel the line. GetLn displays a backslash ( \ ) and issues a carriage 
return, then displays the prompt and waits for you to type a new line. GetLn 
takes the same action when you type more than 255 characters, as 
described above. 

Backspace 

When you press [3 (or | control HTTP , GetLn moves its buffer pointer 
back one space, effectively deleting the last character in its buffer. It also 
sends a backspace character to routine COut, which moves the cursor back 
one space. If you type another character now, it replaces the character you 
backspaced over, both on the display and in the line buffer. 

Each time you press [3, it moves the cursor left and deletes another 
character, until you are back atl the beginning of the line. If you then press 
[3 one more time, you have effectively canceled the line, and GetLn issues 
a carriage return and displays the prompt. The cursor moves even if the 
deleted character is an invisible control character. Thus it is possible for 
screen alignment and buffer alignment to be different. 
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Retype 


See Section 3.2.4. 


ED (or | control HUT) has a function that is complementary to the 
backspace function. When you press ED, GetLn picks up the character 
under the cursor just as if it had been typed on the keyboard. You can use 
this procedure to pick up characters that you just deleted by backspacing 
across them. You can use the backspace and retype functions with the 
cursor-motion functions to edit data on the display. 


3.3 Standard Output Features 


The standard output routine is named COut (character output). COut 
normally calls COutl or C3COutl, which sends one character to the display, 
advances the cursor position, and scrolls the display when necessary. 

COutl and C3COutl restrict their use of the display to an active area called 
the text window, described in Section 3.3.5. 


3.3.1 COut Subroutine 

Your program makes a subroutine call to COut at memory location $FDED 
with a character in the accumulator. COut then passes control via the 
output link CSW to the current output subroutine, normally COutl or 
C3COutl, which takes the character in the accumulator and writes it out. If 
the accumulator contains an uppercase or lowercase letter, a number, or a 
special character, COutl or C3COutl displays it; if the accumulator contains 
a control character, COutl or C3COutl either performs one of the special 
functions described below or ignores the character. 

Each time you send a character to COutl or C3COutl, it displays the 
character at the current cursor position, replacing whatever was there, and 
then advances the cursor position one space to the right. If the cursor 
position is already at the right-hand edge of the window, COutl or C3COutl 
moves it to the leftmost position on the next line down. If this would move 
the cursor position past the end of the last line in the window, COutl or 
C3COutl scrolls the display up one line and sets the cursor position at the 
left end of the new bottom line. 
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▲Warning 


Escape codes are described in Section 3.2.4. 


The cursor position is controlled by the values in memory locations $24 
and $25. These locations are named CH, for cursor horizontal, and CV, for 
cursor vertical. COutl and C3COutl do not display a cursor, but the input 
routines described above do, and they use this cursor position. However, 
changing CV directly does not change the cursor’s vertical position until the 
next carriage return or reaching the end of the current line causes a call to 
VTab (for setting the base address within windows). If some other routine 
displays a cursor, it will not necessarily put it in the cursor position used by 
COutl or C3COutl. 

When the video firmware is set for 80-column display, the value of CH is 
kept at 0 and the true horizontal position is stored at $057B. When the 
80-column video firmware is active, use $057B instead of CH. 


3.3.2 Control Characters With COutl 

COutl does not display control characters. Instead, the control characters 
listed in Table 3-3 are used to initiate some action by the firmware. Other 
control characters are ignored. Most of the functions listed here can also be 
invoked from the keyboard, either by typing the control character listed or 
by using the appropriate escape code. The stop-list function, described 
separately, can only be invoked from the keyboard. 


Table 3-3. Control Characters With COutl 


Control 

Character 

ASCII 

Name 

Apple lie 
Name 

Action Taken by COutl 

CONTROL-G 

BEL 

bell 

Produces a 1000-Hz tone for 

0.1 second 

CONTROL-H 

BS 

backspace 

Moves cursor position one space to 
the left; from left edge of window, 
moves to right end of line above 

CONTROL-J 

LF 

line feed 

Moves cursor position down to next 
line in window; scrolls if needed 

CONTROL-M 

CR 

return 

Moves cursor position to left end of 
next line in window; scrolls if needed 
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3.3.3 Control Characters With C3COut1 


Escape codes are described in Section 3.2.4. 


When the 80-column firmware is active, COut calls C3C0utl instead of 
COutl for character output. C3C0utl does not display control characters, 
but you can use some control characters to control some of what the routine 
does. All other control characters are ignored. 

The control characters listed in Table 3-4 are used to initiate some action by 
the firmware. Except for the stop-list function Q control H~sT) you can 
send control characters to C3COutl either from a program or from the 
Apple He’s keyboard. The stop-list function can only be invoked from the 
keyboard. Most of the functions listed here can also be performed by using 
an equivalent escape code. 


Table 34. Control Characters With C3COutl 


Control 

Character 

ASCII 

Name 

Apple lie 
Name 

Action Taken by C3COutl 

CONTROL-G 

BEL 

bell 

Produces a 1000-Hz tone for 

0.1 second 

CONTROL-H 

BS 

backspace 

Moves cursor position one space to 
the left; from left edge of window, 
moves to right end of line above 

CONTROL-J 

LF 

line feed 

Moves cursor position down to next 
line in window; scrolls if needed 

CONTROL-K 

VT 

clear EOS 

Clears from cursor position to the end 
of the screen* 

CONTROL-L 

FF 

home 
and clear 

Moves cursor position to upper-left 
corner of window and clears window* 

CONTROL-M 

CR 

return 

Moves cursor position to left end of 
next line in window; scrolls if needed 

CONTROL-N 

SO 

normal 

Sets display format normal* 

CONTROL-O 

SI 

inverse 

Sets display format inverse* 

CONTROL-Q 

DC1 

40-column 

Sets display to 40-column* 

CONTROL-R 

DC2 

80-column 

Sets display to 80-column* 

CONTROL-S 

DC3 

stop-list 

Stops listing characters on the display 
until another key is pressedt 
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Table 3-4 — continued. Control Characters With C3C0utl 


Control 

Character 

ASCII 

Name 

Apple lie 
Name 

Action Taken by C3COutl 

CONTROL-U 

NAK 

quit 

Turns off enhanced video firmware* 

CONTROL-V 

SYN 

scroll 

Scrolls the display down one line, 
leaving the cursor in the current 
position* 

CONTROL-W 

ETB 

scroll-up 

Scrolls the display up one line, 
leaving the cursor in the current 
position* 

CONTROL-X 

CAN 

disable 

MouseText 

Disables MouseText character 
display; uses inverse uppercase 

CONTROL-Y 

EM 

home 

Moves cursor position to upper-left 
corner of window (but doesn’t clear)* 

CONTROL-Z 

SUB 

clear line 

Clears the line the cursor position is 
on* 

CONTROL-! 

ESC 

enable 

MouseText 

Maps inverse uppercase characters to 
MouseText characters 

CONTROL-X 

FS 

fwd. space 

Moves cursor position one space to 
the right; from right edge of window, 
moves it to left end of line below* 

CONTROL-] 

GS 

clear EOL 

Clears from the current cursor 
position to the end of the line (that is, 
to the right edge of the window)* 

CONTROL-— 

US 

up 

Moves cursor up a line, no scroll 


* Doesn’t work from the keyboard, 
t Only works from the keyboard. 


3.3.4 The Stop-List Feature 

You can stop the Apple lie from updating its display (if it is using either 
COutl or C3COutl) by pressing | control l - fsl . Whenever COutl or 
C3COutl gets a carriage return from the program, it checks the keyboard for 
a | control hfsl . If a I control hfs~| has been pressed, COutl or C3COutl 
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Important! 

▲Warning 


stops and waits for another key to be pressed before resuming. The 
character code of the key that is pressed is ignored unless it is 
I control H ~c~L which is passed to the program. This feature lets you exit 
BASIC programs from stop-list mode. 


3.3.5 The Text Window 

The active portion of the display is called the text window. After you start 
up the computer or perform a reset, the entire display is the text window. 
COutl or C3COutl puts characters only into the window; when it reaches 
the end of the last line in the window, it scrolls only the contents of the 
window. 

You can restrict video activity to any rectangular portion of the display by 
changing the current text window. Your programs can thus control the 
placement of text in the display and protect other portions of the screen 
from being written over by new text. To do this, store the appropriate 
values into four locations in memory to set the top, bottom, left margin, and 
width of the text window. The following memory locations control the text 
window: 

□ The left margin is stored in memory location $20. This number is 
normally 0, the number of the leftmost column in the display. In a 
40-column display, the maximum value for this number is 39 
(hexadecimal $27); in an 80-column display, the maximum value is 79 
(hexadecimal $4F). 

□ The width of the text window is stored in memory location $21. For a 
40-column display, this value is normally 40 (hexadecimal $28); for an 
80-column display, it is normally 80 (hexadecimal $50). 

□ The position of the top line of the text window is stored in memory 
location $22. This is normally 0, the topmost line in the display. Its 
maximum value is 23 (hexadecimal $17). 

□ The position of the bottom line of the screen plus 1 is stored in memory 
location $23. It is normally 24 (hexadecimal $18) for the bottom line of 
the display. Its minimum value is 1. 

I Pascal does not use this method of supporting window widths. 

Be careful not to let the sum of the window width and the leftmost 
position in the window exceed the width of the display you are using 
(40 or 80 columns). If this happens, COutl or C3COutl may put 
characters into memory locations outside the display page, possibly 
destroying programs or data. 
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Table 3-5 summarizes the memory locations and the possible values for the 
text window parameters. 


Table3-5. Text Window Memory Locations 


Window 

Parameter 

Location 

Minimum 

Value 

Normal Values 

40-col. 80-col. 

Maximum Values 

40-col. 80-col. 


Dec 

Hex 

Dec 

Hex 

Dec 

Hex 

Dec 

Hex 

Dec 

Hex 

Dec Hex 

Left Edge 

32 

$20 

00 

$00 

00 

$00 

00 

$00 

39 

$27 

79 $4F 

Width 

33 

$21 

00 

$00 

40 

$28 

80 

$50 

40 

$28 

80 $50 

Top Edge 

34 

$22 

00 

$00 

00 

$00 

00 

$00 

23 

$17 

23 $17 

Bottom Edge 

35 

$23 

01 

$01 

24 

$18 

24 

$18 

24 

$18 

24 $18 


3.3.6 Normal, Inverse, and Flashing Text 

The way that the Apple lie displays characters is affected by two things: 
the value that is stored in the inverse flag (zero page location $32), and 
whether the enhanced video firmware is off or on. The inverse flag’s 
influence is discussed in the next two subsections. 


If the enhanced video firmware is off, the Apple lie displays what is called 
Both these display character sets are the primary character set; if the video firmware is on, the Apple lie displays 
described in Chapter 5. what is called the alternate character set. 

The primary character set includes normal (light on dark), inverse (dark on 
, light), and flashing (alternating normal and inverse) characters. Lowercase 

inverse characters are not included in the primary character set. 

The alternate character set includes normal and inverse characters 
(including lowercase inverse), and a set of graphic characters called 
MouseText. Flashing characters are not included in the alternate character 
set. 

If you want your program to display a character, it should first load the 
character to be displayed in the accumulator, and then call the 
character-output subroutine COut. For example, to display the character 
corresponding to $C8, you can use something like this: 


LDA #$C8 
JSR COut 
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For a brief explanation of logical functions, 
refer to Appendix H. 


Important! 


MouseText is described more fully in 
Chapter 5. 


See Section 5.2.2. 


Primary Character Set Display 

The primary character set is displayed by COutl, which operates only when 
the enhanced video firmware is off. The primary character set includes text 
in normal, inverse, or flashing format, but not inverse or flashing lowercase 
text. 

If the value of the character sent to COutl is greater than or equal to $A0, 
that value is logically ANDed with the value of the inverse flag (at 
location $32), then displayed. (If you’re curious about which ASCII 
character is being sent, subtract $80 from the value being sent to COutl.) 
You can use the following inverse flag values: 

□ $FF (decimal 255) produces the normal character format. 

□ $3F (decimal 63) produces the inverse character format. 

□ $7F (decimal 127) produces the flashing character format. 

To avoid unusual character display results, use only the three values 
$3F, $7F, and $FF. 

COutl interprets character values from $80 through $9F as control 
characters and tries to execute them. 

Character values from $00 through $7F are all interpreted as display 
characters, not control characters. 

Alternate Character Set Display 

The alternate character set includes normal and inverse format characters 
and the MouseText graphic characters. You should use C3COutl, the 
standard output link when the enhanced video firmware is active , to 
display the alternate character set. Here are the rules for using the alternate 
character set: 

□ Control characters are not displayed. Characters sent to C3COutl are 
interpreted as control characters if they are in the range $00 through $1F 
or $80 through $9F. 

□ Characters in the range $20 through $7F and $A0 through $FF are 
displayed. 

□ If inverse flag (location $32) bit 7 is 1, the character is normal. 

□ If inverse flag bit 7 is 0, the character is inverse. 

□ If MouseText is off, characters $40 through $5F are remapped to the 
range $00 through $1F and are displayed as uppercase inverse 
characters. 

□ If MouseText is on, character values $40 through $5F are left unchanged, 
and the characters are displayed as MouseText. 
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3.4 Port I/O 


The Apple He is a member of the Apple II family of computers; however, 
unlike the Apple II, II Plus, and He, the Apple lie does not have peripheral 
connector slots. In place of these, it has ports— the equivalent of firmware 
interface cards installed in slots. 


3.4.1 Standard Link Entry Points 

To maintain compatibility with existing software and its protocols, each 
port’s I/O firmware has the same standard entry points ($CnOO) as its 
equivalent slot in another Apple II would have. Table 3-6 shows these 
equivalents, as well as listing the chapter where each port is described. 

Section 3.1 describes how and when these entry addresses are placed in 
CSW and KSW. For example, issuing PR#n or IN#n changes the output and 
input links, respectively, so that subsequent output or input is handled by 
the firmware starting at address $CnOO, and thus goes to or comes from the 
selected device. 

Table 3-6. Port Characteristics 


Port 

Entry 

Point 

Port 

Connector 

Use 

Chapter 

1 

$C100 

Serial port 1 

Printers 

7 

2 

$C200 

Serial port 2 

Communication 

8 

3 

$C300 

Video connectors 

Enhanced video 
firmware 

5 

4 

$C400 

Mouse 

Mouse 

9 

5 

$C500 

Intelligent disk port 
devices 



6 

$C600 

Disk drives 

Built-in and 
external drives 

6 

7 

$C700 

No device 

Reserved 

6 


Important! 


The addresses shown in Table 3-6 are not entry points in the sense that 
you can send characters to be printed by sending them to JSR $CnOO. 
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3.4.2 Firmware Protocol 


The Apple lie supports a standard firmware protocol that, in addition to the 
standard link address, provides a table of device identification and entry 
points to standard and optional firmware subroutines. The protocol is 
equivalent to the Pascal 1.1 firmware protocol in use on other Apple IPs, 
and is outlined in Table 3-7. 


Table 3-7. Firmware Protocol Locations 


Address 

Value 

Description 

$Cn05 

$38 

Pascal firmware card/port identifier 

$Cn07 

$18 

Pascal firmware card/port identifier 

$Cn0B 

$01 

Generic signature byte of a firmware card/port 

$Cn0C 

$ci 

Device signature byte: i is an identifier (not 


necessarily unique). 

c = device class (not all used on the Apple lie): 

$00 reserved 

$01 printer 

$02 hand control or other X-Y device 
$03 serial or parallel I/O card/port 
$04 modem 

$05 sound or speech device 

$06 clock 

$07 mass-storage device 

$08 80-column card/port 

$09 network or bus interface 

$0A special purpose (none of the above) 

$0B-0F reserved 

$Cn0D ii $Cnii is the initialization entry address (PInit). 

$Cn0E rr $Cnrr is the read routine entry address (PRead) 

(returns character read in A register). 

$Cn0F ww $Cnww is the write routine entry address 

(PWrite) (enters with character to write in 
A register). 
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Table 3-7 — continued. Firmware Protocol Locations 


For more information, refer to the hardware 
page memory map in Appendix B. 


Address 

Value 

Description 

$CnlO 

ss 

$Cnss is the status routine entry address 
(PStatus) (enters with request code in A register: 
0 to ask “Are you ready to accept output?” or 1 to 
ask “Do you have input ready?”). 

$Cnll 

$00 

if additional address bytes follow; nonzero if not 


Each table begins with identification bytes ($Cn05 through $CnOC). Then, 
starting with address $CnOD, each byte in the table represents the low-order 
byte of the entry-point address of a firmware routine. The high-order byte of 
each address is always $Cn, where n is the port number. Your program uses 
these byte values to construct its own jump table for subroutine calls to the 
ports. 

All port routines require, on entry, that the X register contain $Cn and that 
the Y register contain $n0. 

All routines, on exit, return an error code in the X register (0 means no error 
occurred; 3 means the request was invalid). The carry bit in the program 
status register usually contains a reply to a request code (0 means no; 

1 means yes). 

All the Apple lie ports except the disk port conform to this protocol. The 
disk port is described in Chapter 6. 


3.4.3 Port I/O Space 

By a convention used in other Apple II series machines, each port or slot has 
exclusive use of 16 memory locations set aside for data input and output. 
The addresses of these locations are of the form $C080 + #n0, where n is 
the port or slot number. Table 3-8 lists the port I/O space used in the 
Apple lie. 


Table 3-8. Port I/O Locations 


Port Locations 

1 $C090-$C09F 

2 $C0A0-$C0AF 

6 $C0E0-$C0EF 
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3.4.4 Port ROM Space 


In the Apple II and He, one 256-byte page of memory space is allocated to 
each slot. This space is used for read-only memory (ROM or PROM on the 
interface card) with driver programs that control the operation of 
input/output devices, as outlined in Table 3-7. On the Apple lie, this space 
is dedicated to port firmware. However, I/O ROM space in the Apple lie is 
used as efficiently as possible, and there is not a strict correspondence 
between firmware for port n and the $CnOO space, except as regards entry 
points. 


3.4.5 Expansion ROM Space 

The 2K-byte memory space from $0800 to $CFFF in the Apple lie— called 
expansion ROM space on the Apple II, II Plus, and He — contains the 
enhanced video firmware and port and memory transfer subroutines. The 
Apple lie, unlike the II, II Plus, or II e, always has this space switched in. 


3.4.6 Port Screen Hole RAM Space 

There are 128 bytes of memory (64 in main memory, 64 in auxiliary 
memory) allocated to the ports, 8 bytes per port, as shown in Table 3-9. 
These bytes are reserved for use by the system, except as described in 
Chapters 4 through 9. 


Table 3-9. Port Screen Hole Memory Locations 


Base 

Address 

Ports: 

1 

2 

3 

4 

5 

6 

7 

$0478 

$0479 

$047A 

$047B 

$047C 

$047D 

$047E 

$047F 

$04F8 

$04F9 

$04FA 

$04FB 

$04FC 

$04FD 

$04FE 

$04FF 

$0578 

$0579 

$057A 

$057B 

$057C 

$057D 

$057E 

$057F 

$05F8 

$05F9 

$05FA 

$05FB 

$05FC 

$05FD 

$05FE 

$05FF 

$0678 

$0679 

$067A 

$067B 

$067C 

$067D 

$067E 

$067F 

$06F8 

$06F9 

$06FA 

$06FB 

$06FC 

$06FD 

$06FE 

$06FF 

$0778 

$0779 

$077A 

$077B 

$077C 

$077D 

$077E 

$077F 

$07F8 

$07F9 

$07FA 

$07FB 

$07FC 

$07FD 

$07FE 

$07FF 
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▲Warning 


Appendix E describes interrupt handling on 
the Apple lie. 


These addresses are unused bytes in the RAM reserved for text and 
low-resolution graphics displays, and hence they are sometimes called 
screen holes. These particular locations are not displayed on the screen and 
their contents are not changed by the built-in output routines. In other 
words, they are used by the output routines but they are not part of the 
video display. 

All the screen holes in auxiliary memory, and many of them in main 
memory, are reserved for special use by Apple lie firmware— for 
example, to store initialization information. Do not use any locations 
marked reserved in this manual. 

The way that port firmware uses these RAM locations and their addresses is 
covered in Chapters 4 through 10. 


3.5 Interrupts 


Interrupts are a way to more efficiently use the hardware in a computer. 
Interrupt support built into the Apple He’s firmware is described briefly 
below. 

When the IRQ line on the 65C02 microprocessor is activated, the 65C02 
transfers program control through the vector in locations $FFFE through 
$FFFF of ROM or whichever bank of RAM is switched in (Chapter 2). If 
ROM is switched in, this vector is the address of the Monitor’s interrupt 
handler, which determines whether the request is due to an interrupt that 
should be handled internally. If so, the Monitor handles it and then returns 
control to the interrupted program. 

If the interrupt is due to a BRK ($00) instruction, control is transferred 
through the BRK vector (S03F0-03F1). Otherwise, control is transferred 
through the IRQ vector ($03FE-$03FF). 
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This chapter describes how to use two of the Apple He’s built-in devices: the 
keyboard and the speaker. 



4.1 Keyboard Input 

For a description of how the keyboard 
strobe works, refer to Appendix E. 

Table 4-1 describes the characteristics of the keyboard that relate to 
programming. You won’t have to write routines to read the keyboard from 
all your assembly-language programs since the Apple lie firmware Monitor 
provides keyboard support through the three standard input routines 
described in Chapter 3— RdKey, Keyln, and GetLn. You can do all your 
keyboard handling directly in your programs if you want to, but it’s nice to 
know that you’re not forced to. 

4.1.1 Reading the Keyboard 

The keyboard encoder and ROM (see Chapter 11) can generate all 

128 ASCII codes, so all the special character codes in the ASCII character 
set are available from the keyboard. Your machine-language programs can 
call RdKey to get characters from the keyboard. RdKey reads characters a 
byte at a time from the keyboard data location ($C000) shown in Table 4-1. 

Here is how your programs should go about reading the keyboard: 

1. Test bit 7 of address $C000 to see if a key has been pressed. Bit 7 is the 
keyboard strobe bit. 

2. When bit 7 goes to a 1, you know that the low-order seven bits of $C000 
are a valid character. 

3. Clear the keyboard strobe (bit 7) at $C000 by reading or writing 
anything to address $C010. 

$C010 has another function besides clearing the keyboard strobe: its high 
bit is a 1 while a key is pressed (except the Apple keys, | control I, | shift |, 

1 caps lock |, and | reset |). Bit 7 at this location is therefore called 
any-key-dowri. You could use this to let a program do something useful 
other than just waiting for the next key to be pressed. (People are generally 
a lot slower than the Apple lie.) Check $C010 occasionally to see if 
something should be done. 

Important! 

If your program needs to read both the keyboard flag and strobe, it must 
read the strobe bit first. Anytime you read the any-key-down bit at $C010, 
you also clear the keyboard strobe bit at $C000. 
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Table 4-1. Keyboard Input Characteristics 


Game input switches: See Chapter 9. 


GetLn, GetLnl, and RdKey: See Chapter 3. 


Port number: None 

Commands: Keyboard is always on, in the sense that any keypress 

generates a KSTRB. 

Initial 

characteristics: Reset routine clears the keyboard strobe and sets the 

keyboard as the standard input device (that is, sets KSW to 
point to RdKey). 


Hardware locations: 


$cooo 

Keyboard data and strobe 

$C010 

Any-key-down flag and clear-strobe switch 

$C060 

40-column switch status on bit 7; 

1 = 40-column display = switch down 

$C061 

fol status on bit 7; 1 = pressed (also game input switch 0) 

$C062 

ran status on bit 7; 1 = pressed 

Monitor firmware routines: 


Location 

Name 

Description 

$FD6A 

GetLn 

Gets an input line with prompt 

$FD67 

GetLnZ 

Gets an input line with preceding carriage 
return 

$FD6F 

GetLnl 

Gets an input line, but with no preceding 
prompt 

$FD1B 

Keyln 

The keyboard input subroutine 

$FD35 

RdChar 

Gets an input character or escape code 

$FD0C 

RdKey 

The standard character input subroutine 


Use of other pages: 

Page 2 The standard character string input buffer (see GetLn 

description) 


4.1 Keyboard Input 
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After your program has cleared the keyboard strobe, the strobe remains low 
until another key is pressed. 

Table 4-2 shows the ASCII codes generated by all the keys on the Apple lie 
keyboard. Remember, if the strobe bit is set, the character values that your 
program sees will be equal to the values given in Table 4-2 plus $80. 


Table 4-2. Keys and ASCII Codes 

Nota Codes are in hexadecimal here ; refer to Table G-8 for decimal equivalents. 


Key 

Key Alone 

+ CONTROL 

+ SHIFT 

+ Both 


Code 

Char 

Code 

Char 

Code 

Char 

Code 

Char 

I DELETE | 

7F 

DEL 

7F 

DEL 

7F 

DEL 

7F 

DEL 

EJ 

08 

BS 

08 

BS 

08 

BS 

08 

BS 

1 TAB 1 

09 

HT 

09 

HT 

09 

HT 

09 

HT 

ra 

0A 

LF 

0A 

LF 

0A 

LF 

0A 

LF 

ra 

OB 

VT 

0B 

VT 

0B 

VT 

0B 

VT 

| RETURN | 

0D 

CR 

0D 

CR 

0D 

CR 

0D 

CR 

0 

15 

NAK 

15 

NAK 

15 

NAK 

15 

NAK 

me] 

IB 

ESC 

IB 

ESC 

IB 

ESC 

IB 

ESC 

| SPACE | 

20 

SP 

20 

SP 

20 

SP 

20 

SP 

j >j 

27 

) 

27 

’ 

22 

» 

22 


,< 

2C 

) 

2C 

> 

3C 

< 

3C 

< 

- — 

2D 

- 

IF 

US 

5F 



IF 

US 

. > 

2E 


2E 


3E 

> 

3E 

> 

/? 

2F 

/ 

2F 

/ 

3F 

9 

3F 

? 

0) 

30 

0 

30 

0 

29 

) 

29 

) 

1! 

31 

1 

31 

1 

21 

! 

21 

! 

2@ 

32 

2 

00 

NUL 

40 

@ 

00 

NUL 

3# 

33 

3 

33 

3 

23 

# 

23 

# 

4$ 

34 

4 

34 

4 

24 

$ 

24 

$ 

5% 

35 

5 

35 

5 

25 

% 

25 

% 

6 * 

36 

6 

IE 

RS 

5E 

- 

IE 

RS 

7& 

37 

7 

37 

7 

26 

& 

26 

& 

8* 

38 

8 

38 

8 

2A 

* 

2A 

* 

9( 

39 

9 

39 

9 

28 

( 

28 

( 

J * 

3B 

) 

3B 

; 

3A 


3A 
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Table 4-2— continued. Keys and ASCII Codes 

Note: Codes are in hexadecimal here; refer to Table G-8for decimal equivalents. 


Key 

Key Alone 

+ CONTROL 

+ SHIFT 

+ Both 


Code 

Char 

Code 

Char 

Code 

Char 

Code 

Char 

= + 

3D 

= 

3D 

= 

2B 

+ 

2B 

+ 

[{ 

5B 

[ 

IB 

ESC 

7B 

{ 

IB 

ESC 

\l 

5C 

\ 

1C 

FS 

7C 

i 

1C 

FS 

]}, 

5D 

i 

ID 

GS 

7D 

} 

ID 

GS 


60 


60 


7E 


7E 


A 

61 

a 

01 

SOH 

41 

A 

01 

SOH 

B 

62 

b 

02 

STX 

42 

B 

02 

STX 

C 

63 

c 

03 

ETX 

43 

C 

03 

ETX 

D 

64 

d 

04 

EOT 

44 

D 

04 

EOT 

E 

65 

e 

05 

ENQ 

45 

E 

05 

ENQ 

F 

66 

f 

06 

ACK 

46 

F 

06 

ACK 

G 

67 

t 

07 

BEL 

47 

G 

07 

BEL 

H 

68 

h 

08 

BS 

48 

H 

08 

BS 

I 

69 

i 

09 

HT 

49 

I 

09 

HT 

J 

6A 

j 

0A 

LF 

4A 

J 

0A 

LF 

K 

6B 

k 

0B 

VT 

4B 

K 

0B 

VT 

L 

6C 

1 

OC 

FF 

4C 

L 

OC 

FF 

M 

6D 

m 

0D 

CR 

4D 

M 

0D 

CR 

N 

6E 

n 

0E 

SO 

4E 

N 

0E 

SO 

0 

6F 

0 

OF 

SI 

4F 

O 

OF 

SI 

P 

70 

P 

10 

DLE 

50 

P 

10 

DLE 

Q 

71 

q 

11 

DC1 

51 

Q 

11 

DC1 

R 

72 

r 

12 

DC2 

52 

R 

12 

DC2 

S 

73 

s 

13 

DC3 

53 

S 

13 

DC3 

T 

74 

t 

14 

DC4 

54 

T 

14 

DC4 

U 

75 

u 

15 

NAK 

55 

U 

15 

NAK 

V 

76 

V 

16 

SYN 

56 

V 

16 

SYN 

W 

77 

w 

17 

ETB 

57 

W 

17 

ETB 

X 

78 

X 

18 

CAN 

58 

X 

18 

CAN 

Y 

79 

y 

19 

EM 

59 

Y 

19 

EM 

Z 

Ik 

z 

1A 

SUB 

5A 

Z 

1A 

SUB 
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Keystrokes can also generate interrupts: 
See Appendix E. 


This restarting process is called the reset 
routine, and is described in Chapter 2. 

For information on how to have programs 
interpret keystrokes in a standard way, 
refer to th z Apple II Design Guidelines 
listed in the Bibliography. 


There are several keys that do not generate ASCII codes themselves, but 
alter the characters produced by other keys. These modifier keys are 

| CONTROL 1 , [ SHIFT |, and | CAPS LOCK~| . 

Your programs can also use the [5] and ® as character modifier keys while 
handling keyboard input, and, if one or both of them is pressed, branch to a 
special routine, such as a help program. Your program can read [5] at $C061 
and [¥] at $C062. 

Another key that doesn’t generate a code is | reset |, located at the 
upper-left corner of the keyboard; it is connected directly to the Apple He’s 
processor. Pressing | reset | with | control [ depressed normally causes the 
system to stop whatever program it’s running and restart itself. If you hold 
f51 while pressing | control h reset |, the Apple lie performs a forced cold 
start. The restart sequence is described in Chapter 2. 


4.1.2 Monitor Firmware Support for Keyboard Input 

Chapter 3 describes the three standard Monitor input routines serving the 
keyboard: GetLn, RdKey, and Keyln. This section discusses the three other 
available Monitor routines. 


GetLnZ 

GetLnZ (at address $FD67) is an alternate entry point for GetLn that first 
sends a carriage return to the standard output, then continues into GetLn. 

GetLn 1 

GetLnl (at address $FD6F) is an alternate entry point for GetLn that does 
not issue a prompt before it accepts the input line. However, if the user 
cancels the input line with too many backspaces or with | control tfxl, 
then GetLnl issues the prompt stored at location $33 when it gets another 
line. 


RdChar 

RdChar (at address $FD35) is a subroutine that gets characters from the 
standard input subroutine, and also interprets the escape codes listed in 
Chapter 3. 

If the enhanced video firmware is active, [3 (I control HUD reads a 
character from the screen as if it were typed from the keyboard. This is a 
function of the Monitor’s built-in editing capability described in Chapter 3. 
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Electrical specifications of the speaker 
circuit appear in Chapter 11. 


Important! 


4.2 Speaker Output 

The Apple lie has a small speaker mounted near the front of the bottom 
plate of its case. The speaker is connected to a soft switch that toggles; that 
is, the switch has two states, off and on, and it changes from one to the 
other each time it is accessed. Table 4-3 describes the speaker output 
characteristics. 

Table 4-3. Speaker Output Characteristics 

Port number: None 

Commands: Some programs sound the speaker in response to 

CONTROL-G. 

Initial 

characteristics: Reset routine sounds the speaker. 

Hardware location: 

$C030 Toggle speaker (read only) 

Monitor firmware routines: 


Location 

Name 

Description 

$FBDD 

Belli 

Sends a beep to the speaker 

$FF3A 

Bell 

Sends CONTROL-G to the current output 


4.2.1 Using the Speaker 

If you switch the speaker once, by reading or writing to $C030, it emits a 
click; to make longer sounds, access the speaker repeatedly. The switch for 
the speaker uses memory location $C030. You can make various tones and 
buzzes with the speaker by using combinations of timing loops in your 
program. 

You should always use a read operation to toggle the speaker. If you write 
to this soft switch, it switches twice in rapid succession. The resulting 
pulse is so short that the speaker doesn’t have time to respond; it doesn’t 
make a sound. 


4.2 Speaker Output 
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4.2.2 Monitor Firmware Support for Speaker Output 


See Chapter 3. The Monitor supports the speaker with one simple routine, Belli . A related 

routine, Bell, supports the current output device— the one that CSW points 
to. 

Belli 

Belli (at address $FDBB) makes a beep through the speaker by generating a 
1-kHz tone in the Apple He’s speaker for 0.1 second. This routine scrambles 
the A and X registers. 

Bell 

The Monitor routine Bell (at location $FF3A) writes a bell control character 
(ASCII CONTROL-G) to the current output device. This routine leaves the 
accumulator holding $87. 
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NTSC stands for National Television 
Standards Committee, a group that 
formulates broadcast and reception 
guidelines used by the USA and several 
other countries. 


Important! 


The Apple He’s primary output device is its video display. You can use any 
ordinary color or monochrome video monitor with the Apple lie. An 
ordinary monitor is one that accepts NTSC-compatible composite video. If 
you use Apple lie color graphics with a black-and-white monitor, the display 
will appear as black, white, and two shades of gray. 

If you are only using graphics modes and 40-column text, you can use a 
television set for your video display. If the TV set has an input connector for 
composite video, you can connect it directly to your Apple He; otherwise, 
you must attach an RF video modulator between the Apple lie and the 
television set. 

The Apple lie can produce an 80-column text display. However, if you use 
an ordinary color or black-and-white television set, 80-column text will be 
too blurry to read. For a clear 80-column display, you must use a 
high-resolution video monitor with a bandwidth of 14 MHz or greater. 

Table 5-1 summarizes the video output port’s characteristics and points to 
other information in this chapter. 

Table5-1. Video Output Port Characteristics 


Port number: 

Output port 3 

Commands: 

See Figure 5-3 

Initial characteristics: 

See Figure 5-3 

Note: If a program is to use the 
enhanced video firmware, it should 
turn it on and then immediately check 
the 80/40 switch. If the switch is in 
the 40 position, the program should 
issue a CONTROL-Q. 

Hardware locations: 

See Table 5-7 

Monitor firmware routines: 

See Table 5-11 

I/O firmware entry points: 

See Table 5-12 
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See Section 11.9.5 for more on video 
expansion hardware. 


5.1 Video Display Specifications 


Table 5-2 summarizes the video display’s specifications, and provides a 
further guide to other information in this chapter. 


Table 5-2. Video Display Specifications 


Display modes: 


Text capacity: 

Character set: 

Display formats: 

Low-resolution graphics: 
High-resolution graphics: 

Double-high-resolution graphics: 


40-column text; map: Figure 5-5 
80-column text; map: Figure 5-6 

Low-resolution color graphics; 
map: Figure 5-7 

High-resolution color graphics; 
map: Figure 5-8 

Double-high-resolution color graphics; 
map: Figure 5-9 

24 lines by 80 columns (character 
positions) 

96 ASCII characters (uppercase and 
lowercase) 

Normal, inverse, flashing, MouseText 
(Table 5-3) 

16 colors (Table 5-4): 40 horizontal by 
48 vertical; map: Figure 5-7 

6 colors (Table 5-5): 140 horizontal by 
192 vertical (restricted) 

Black-and-white: 280 horizontal by 
192 vertical; map: Figure 5-8 

16 colors (Table 5-6): 140 horizontal by 
192 vertical (no restrictions) 

Black-and-white: 560 horizontal by 
192 vertical; map: Figure 5-9 


The video signal produced by the Apple lie is NTSC-compatible composite 
color video available at two places on the back panel of the Apple lie: the 
RCA-type phono jack and the 15-pin D-type connector. Use the RCA-type 
phono jack to connect a video monitor, and the DB-15 connector for an 
external video modulator or other video expansion hardware. 


5.1 Video Display Specifications 
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MouseText: See Section 5.2.2. 


5.2 Text Modes 


Either of the Apple lie’s two text modes can display all 96 ASCII characters: 
uppercase and lowercase letters, the ten digits, punctuation marks, and 
special characters. Each character is displayed in an area of the screen that 
is seven dots wide by eight dots high. The characters are formed by a dot 
matrix five dots wide (with a few exceptions, such as underscore), leaving 
two blank columns of dots between characters in a row. Except for 
lowercase letters with descenders, the characters are only seven dots high, 
leaving one blank line of dots between rows of characters. 

The normal display has white (or other monochrome color used by your 
monitor) dots on a dark background. Characters can also be displayed as 
black dots on a white background; this is called inverse format. 


5.2.1 Text Character Sets 


The Apple lie can display either of two text character sets: the primary set 
and an alternate set (Table 5-3). The forms of the characters in the two sets 
are actually the same, but the available display formats are different. The 
display formats are 

□ normal, with white dots on a black screen 

□ inverse, with black dots on a white screen 

□ flashing, alternating between normal and inverse. 

The Apple lie can display uppercase characters in all three formats— 
normal, inverse, and flashing — with the primary character set. Lowercase 
letters can only be displayed in normal format. This makes the primary 
character set compatible with most software written for the Apple II and 
II Plus, which can display text in flashing format but don’t have lowercase 
characters. 

The alternate character set trades the flashing format for a complete set of 
inverse characters. With the alternate character set, the Apple lie can 
display uppercase letters, lowercase letters, numbers, and special 
characters in either normal format or inverse format. It can also display 
MouseText. 

You can select between character sets with the alternate-text soft switch, 
described in Section 5.6. Table 5-3 shows the character codes in decimal 
and hexadecimal for the Apple lie primary and alternate character sets in 
normal, inverse, and flashing formats. 
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Table 5-3. The Display Character Sets 


To identify particular characters and 

Hex 

Primary Character Set 

Alternate Character Set 

values, refer to Table 4-2. 

Values 

Character Type 

Format 

Character Type 

Format 


$00-$lF 

Uppercase letters 

Inverse 

Uppercase letters 

Inverse 


$20-$3F 

Special characters 

Inverse 

Special characters 

Inverse 


$40-$5F 

Uppercase letters 

Flashing 

MouseText 



$60-$7F 

Special characters 

Flashing 

Lowercase letters 

Inverse 


$80-$9F 

Uppercase letters 

Normal 

Uppercase letters 

Normal 


$A0-$BF 

Special characters 

Normal 

Special characters 

Normal 


$C0-$DF 

Uppercase letters 

Normal 

Uppercase letters 

Normal 


$E0-$FF 

Lowercase letters 

Normal 

Lowercase letters 

Normal 


Each character on the screen is stored as one byte of display data. The 
low-order six bits make up the ASCII code of the character being displayed. 
The remaining two (high-order) bits select format and the group within 
ASCII (Section 3.3.6). 


5.2.2 MouseText 

The alternate character set contains 32 graphics characters called 
MouseText in place of the primary set’s inverse uppercase characters from 
$40 through $5F. These graphics are especially convenient to use with a 
mouse, since they can be generated by character codes instead of groups of 
high-resolution byte values, and they can be moved around quickly. To use 
MouseText characters, do the following: 

1. Turn on the enhanced video firmware with PR#3 or 6 CONTROL-P. 

2 . Set inverse mode: use the INVERSE command or put $3F in 
location $32, or print CONTROL-O. 

3 . Turn on MouseText with PRINT CHR$(27); or pass $1B to COut in the 
accumulator. 

4 . Print the uppercase letter (or other ASCII character in the range $40 
through $5F: @ [ \] 'or_) that corresponds to the MouseText 
character you want. 

5 . Turn off MouseText with PRINT CHR$(24); or pass $18 to COutl in the 
accumulator. 


5.2 Text Modes 
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6 . Set normal mode: use the NORMAL command or put $FF in 
location $32, or print a CONTROL-N. 

Here is a sample Applesoft program that prints all the MouseText 
characters: 

10 D$ = CHR $ { 4 ) 

20 PRINT PRINT D$; n PR#3 n 
30 INVERSE 

40 PRINT CHR$(27); ,, @ABCDEFGHIJKLMNQPQRSTUVWXYZ[] a _" ; 
50 PRINT CHRSC24); 

60 NORMAL 

MouseText characters and their corresponding ASCII characters are shown 
in Figure 5-1. 


Figure 5-1. MouseText Characters 
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5.2.3 40-Column Versus 80-Column Text 

The Apple lie has two text display modes: 40-column and 80-column. The 
number of dots in each character does not change, but the characters in 
80-column mode are only half as wide as the characters in 40-column mode. 
Compare the two displays in Figure 5-2. On an ordinary color or 
black-and-white television set, the narrow characters in the 80-column 
display blur together; you must use the 40-column mode to display text on a 
television set. 
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Figure 5-2. 40-Column and 80-Column Text (With Alternate Character Set) 


] L I ST 0,100 

10 REM APPLESOFT CHARACTER DEMO 

20 TEXT : HOME 

30 PRINT : PRINT “Applesoft Char 
acter Demo” 

40 PRINT : PRINT "Which characte 
r set — " 

50 PRINT : INPUT 'Primary (P) or 
Alternate (A) ?"A$ 

60 IF LEN CA$) < 1 THEN 50 

65 LET A* = LEFT* CA$, 1) 

70 IF A* - "P" THEN POKE 49166, 
0 

80 IF A* = "A" THEN POKE 49167, 
0 

90 PRINT : PRINT "...printing th 
e same line, first" 

100 PRINT ' in NORMAL, then INVE 
RSE , then FLASH:": PRINT 


1 


] L I ST 0,100 



10 

REM APPLESOFT 

CHARACTER DEMO 

20 

TEXT : 

HOME 


30 

PRINT ; 

PRINT 

"Applesoft Character Demo" 

40 

PRINT : 

PRINT 

"Which character set—" 

50 

PRINT : 

INPUT 

"Primary CP> or Alternate (A> ?";AS 

60 

IF LEN 

( AS ) < 

1 THEN 50 

65 

LET A$ 

- LEFTS 

(AS, 1) 

70 

IF A $ - 

"P" THEN POKE 49166,0 

80 

IF A$ - 

"A" THEN POKE 49167,0 

90 

PRINT : 

PRINT 

"...printing the same line, first" 

100 

PRINT 

» in NORMAL, then INVERSE, then FLASH:": PRINT 


5.2 Text Modes 
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Figure 5-3 shows the characteristics of the text display modes and how to 
switch between them. 


Figure5-3. Text Mode Characteristics and Switching 


Power On 


( ESC IfCONTROL ) -fcT) 



Output hook: C3COut1 
Window: 40 columns, 

24 lines 

Character Set: alternate 


Output hook: C3COut1 
Window: 80 columns, 

24 lines 

Character Set: alternate 
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5.3 Graphics Modes 


The Apple lie can produce color video graphics in any of three different 
modes: 

□ low-resolution graphics, 48 rows by 40 columns 

□ high-resolution graphics, 192 rows by 280 columns 

□ double-high-resolution graphics, 192 rows by 560 columns 

Each graphics mode treats the screen as a rectangular array of spots. 
Normally, your programs will use the features of some high-level language 
to draw graphics dots, lines, and shapes on the screen; this section describes 
the way the resulting graphics data are stored in the Apple He’s memory. 


5.3.1 Low-Resolution Graphics 

The Apple lie displays an array of 48 rows by 40 columns of colored blocks 
in the low-resolution graphics mode. Each block can be any one of sixteen 
colors, including black and white. On a black-and-white monitor or 
television set, these colors appear as black, white, and two shades of gray. 
There are no blank dots between blocks; adjacent blocks of the same color 
merge to make a larger shape. 

The low-resolution graphics display data are stored in the same part of 
memory as the data for the 40-column text display. Each byte contains data 
for two low-resolution graphics blocks. The two blocks are displayed one 
atop the other in a display space the same size as a 40-column text 
character, seven dots wide by eight dots high. 

Half a byte— four bits, or one nibble— is assigned to each graphics block. 
Each nibble can have a value from 0 to 15, and this value determines which 
one of sixteen colors appears on the screen. The colors and their 
corresponding nibble values are shown in Table 5-4. In each byte, the 
low-order nibble sets the color for the top block of the pair, and the 
high-order nibble sets the color for the bottom block. Thus, a byte 
containing the hexadecimal value $D8 produces a brown block atop a 
yellow block on the screen. 


5.3 Graphics Modes 
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Table 5-4. Low-Resolution Graphics Colors 

Note: Colors may vary, depending on ac^ustme^ ofmomtor or television set. 


Nibble Value 

Decimal Hex 

Color 

0 

$00 

black 

1 

$01 

magenta 

2 

$02 

dark blue 

3 

$03 

purple 

4 

$04 

dark green 

5 

$05 

gray 1 

6 

$06 

medium blue 

7 

$07 

light blue 


Nibble Value 


Decimal 

Hex 

Color 

8 

$08 

brown 

9 

$09 

orange 

10 

$0A 

gray 2 

11 

$0B 

pink 

12 

$0C 

light green 

13 

$0D 

yellow 

14 

$0E 

aquamarine 

15 

$0F 

white 


As explained in Section 5.5, the text display and the low-resolution graphics 
display use the same area in memory. Your programs should usually clear 
this part of memory when they change display modes, but you can store 
data as text and display them as graphics, or vice versa. All you have to do 
is change the mode switch, described in Section 5.6, without changing the 
display data. This usually produces meaningless jumbles on the display, but 
some programs have used this technique to good advantage for producing 
complex low-resolution graphics displays quickly. 


5.3.2 High-Resolution Grap hics 

In the high-resolution graphics mode, the Apple lie displays an array of 
colored dots in 192 rows and 280 columns. The colors available are black, 
white, purple, green, orange, and blue, although the colors of the individual 
dots are limited, as described below, by the color of adjacent dots. Adjacent 
dots of the same color merge to form a continuous colored area. 

High-resolution graphics display data are stored in either of two 8192-byte 
areas in memory. These areas are called high-resolution Page 1 and Page 2; 
think of them as display data buffers. Normally, your programs will use the 
features of some high-level language to draw graphics dots, lines, and 
shapes to display; this section describes the way the resulting graphics data 
are stored in the Apple He’s memory. 


88 


Chapter 5: Video Display Output 


The Apple lie high-resolution graphics display is bit-mapped: each dot on 
the screen corresponds to a bit in the Apple He’s memory. The seven 
low-order bits of each display byte control a row of seven adjacent dots on 
the screen, and 40 adjacent bytes in memory control a row of 280 
(7 times 40) dots. The eighth bit (the most significant) of each byte is not 
displayed; it selects one of two color sets, as described below. The least 
significant bit of each byte is displayed as the leftmost dot in a row of seven, 
followed by the next-least significant bit, and so on, as shown in Figure 5-4. 


Figure 5-4. High-Resolution Display Bits 


Bits in Data Byte 



There is a simple correspondence between bits in memory and dots on the 
screen on a black-and-white monitor. A dot is white if the bit controlling it is 
on (1), and the dot is black if the bit is off (0). On a black-and-white 
television set, pairs of dots merge together; alternating black and white dots 
merge to a continuous gray. 

A dot whose controlling bit is off (0) is black on an NTSC color monitor or a 
color television set. If the bit is on, the dot is white or a color, depending on 
its position, the dots on either side, and the setting of the high-order bit of 
the byte. Call the leftmost column of dots column 0, and assume (for the 
moment) that the high-order bits of all the data bytes are off (0). If the bits 
that control them are on, dots in even-numbered columns, 0, 2, 4, and so 
forth, are purple, and dots in odd-numbered columns are green— but only if 
the dots on either side are black. If two adjacent dots are both on, they are 
both white. 


5.3 Graphics Modes 


You select the other two colors, blue and orange, by turning the high-order 
bit (bit 7) of a data byte on (1). The colored dots controlled by a byte with 
the high-order bit on are either blue or orange: the dots in even-numbered 
columns are blue, and the dots in odd-numbered columns are orange (again, 
only if the dots on either side are black). Within each horizontal line of 
seven dots controlled by a single byte, you can have black, white, and one 
pair of colors. To change the color of any dot to one of the other pair of 
colors, you must change the high-order bit of its byte, which affects the 
colors of all seven dots controlled by the byte. 

In brief, high-resolution graphics displayed on a color monitor or television 
set are made up of colored dots, according to the following rules: 

□ Dots in even-numbered columns can be black, purple, or blue. 

□ Dots in odd-numbered columns can be black, green, or orange. 

□ If adjacent dots in a row are both on, they are both white. 

□ The colors in each row of seven dots controlled by a single byte are either 
purple and green, or blue and orange, depending on whether the 
high-order bit is off (0) or on (1). 

These rules are summarized in Table 5-5. The blacks and whites are 
numbered to remind you that the high-order bit is different. 


Table 5-5. High-Resolution Graphics Colors 

Note Colors maAj_ vary, de^endinc/^ on adjustment of_ monitor or television set. 


Bits 0-6 

Bit 7 Off 

Bit 7 On 

Adjacent columns off 

black 1 

black 2 

Even columns on 

purple 

blue 

Odd columns on 

green 

orange 

Adjacent columns on 

white 1 

white 2 


For more details about the way the 
Apple lie produces color on a TV set, see 
Chapter 11. For a table of reversed bit 
patterns, refer to Appendix H. 


The peculiar behavior of the high-resolution colors reflects in part the way 
NTSC color television works. The dots that make up the Apple lie video 
signal are spaced to coincide with the frequency of the color subcarrier used 
in the NTSC system. Alternating on and off dots at this spacing cause a 
color monitor or TV set to produce color, but two or more on dots together do 
not. 
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5.3.3 Double-High-Resolution Graphics 


Important! 


The horizontal resolution of double-high-resolution graphics is 560 dots per 
line, with 192 lines. Double-high-resolution graphics maps the low-order 
seven bits of the bytes in the two double-high-resolution graphics pages. A 
double-high-resolution page is made up of a 8192-byte page in main memory 
and an equivalent page having the same address in auxiliary memory. In 
most cases, only the first double-high-resolution graphics page is used. 

The bytes in the main-memory and auxiliary-memory pages are displayed 
in exactly the same manner as the characters in 80-column text: of each 
pair of identical addresses, the auxiliary-memory byte is displayed first, and 
the main-memory byte is displayed second. A dot whose controlling bit is 
off (0) is black when displayed. 

Unlike high-resolution color (Section 5.3.2), double-high-resolution color has 
no restrictions on which colors can be adjacent. Color is determined by any 
four adjacent dots along a line. Think of a four-dot-wide window moving 
across the screen: at any given time, the color displayed corresponds to the 
4-bit value from Table 5-6 that corresponds to the window’s position 
(Figure 5-9). Effective horizontal resolution with color is 140 (560 divided 
by 4). 

Table 5-6, on the next page, describes the data values used to produce colors 
in double-high-resolution graphics. To use the table, divide the column 
number by 4, and use the remainder to find the correct column: abO is a 
byte residing in auxiliary memory corresponding to a remainder of 0 
(byte 0, 4, 8, and so on), mbl is a byte residing in main memory 
corresponding to a remainder of 1 (byte 1, 2, 9 and so on), and similarly for 
ab2 and mbS. 


5.4 Mixed-Mode Displays 


Any of the graphics displays can have four lines of text, either 40-column or 
80-column, at the bottom of the screen. Graphics displays with text at the 
bottom are called mixed-mode displays. To use them, the TEXT switch 
must be off (read $C050) and the MIXED switch on (read $C053). 

I You cannot display 40-column text with double-high-resolution graphics. 

To determine what appears where in mixed-mode displays, refer to Figures 
5-5 through 5-9 in Section 5.7. See the bottom sixth of the appropriate text 
display (Figure 5-5 or 5-6) and the upper five-sixths (down to the heavy 
horizontal line) in the appropriate graphics display (Figures 5-7 to 5-9). 


5.4 Mixed-Mode Displays 
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Table 5-6. Double-High-Resolution Graphics Colors 

Note : Colors may vary, depending on adjustment of monitor or television set. 


Color 

abO 

mbl 

ab2 

mb3 

Repeated 

Bit Pattern 

black 

$00 

$00 

$00 

$00 

0000 

magenta 

$08 

$11 

$22 

$44 

0001 

brown 

$44 

$08 

$11 

$22 

0010 

orange 

$4C 

$19 

$33 

$66 

0011 

dark green 

$22 

$44 

$08 

$11 

0100 

gray 1 

$2A 

$55 

$2A 

$55 

0101 

green 

$66 

$4C 

$19 

$33 

0110 

yellow 

$6E 

$5D 

$3B 

$77 

0111 

dark blue 

$11 

$22 

$44 

$08 

1000 

purple 

$19 

$33 

$66 

$4C 

1001 

gray 2 

$55 

$2A 

$55 

$2A 

1010 

pink 

$5D 

$3B 

$77 

$6E 

1011 

medium blue 

$33 

$66 

$4C 

$19 

1100 

light blue 

$3B 

$77 

$6E 

$5D 

1101 

aqua 

$77 

$6E 

$5D 

$3B 

1110 

white 

$7F 

$7F 

$7F 

$7F 

mi 

"] = Unused bit 





Memory 7 6 5 4 3 

2 1 0 | 7 

'6 5 4 3 

Bits in Data Byte 

2 1 O | 7 6 5 

4 3 2 1 O | 

7 6 5 4 3 2 1 0 

abO 

1 

mbl 

i a 

ab2 

mb3 

Display 1 0 1 2 3 1 

0 12 

3 | 0 1 2 

3 | 0 1 2 3 | 

0 1 2 3 | 0 

1 2 3 I O 1 2 3 j 


Dots on Graphics Screen 
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5.5 Display Pages 

Important! 

The Apple lie uses data stored in specific areas in memory to generate its 
video displays. These areas, called display pages, serve as buffers where 
your programs can put data to be displayed. Each byte in a display buffer 
controls an object— a character, a colored block, or a group of adjacent 
dots— at a certain location on the display, depending on the current display 
mode. 

The 40-column-text and low-resolution-graphics modes use two display 
pages of 1024 bytes each. These are called text Page 1 and text Page 2, and 
they are located at $0400 through $07FF and $0800 through $0BFF in main 
memory. Normally, only Page 1 is used, but you can put text or graphics 
data into Page 2 and switch between displays. Either page can be displayed 
as 40-column text, low-resolution graphics, or mixed-mode (four lines of text 
at the bottom of a graphics display). 

The 80-column text mode displays twice as much data as the 40-column 
mode— 1920 bytes— but it cannot switch pages when the enhanced video 
firmware is active. The 80-column text display uses a combination page 
made up of text Page 1 in main memory plus another page in auxiliary 
memory. This additional memory is not the same as text Page 2— in fact, it 
is text Page IX, and it occupies the same address space as text Page 1 (see 
Figure 2-11). The built-in firmware I/O routines described in Chapter 3 take 
care of this extra addressing automatically; that is one reason to use these 
routines for all normal text output. 

The built-in video firmware always displays Page 1 text. You cannot 

write text to Page 2 with the built-in firmware. 

The high-resolution graphics mode also has two display pages, but each 
page is 8192 bytes long. In the 40-column text and low-resolution graphics 
modes each byte controls a display area seven dots wide by eight dots high. 
In high-resolution graphics mode each byte controls an area seven dots wide 
by one dot high. Thus, a high-resolution display requires eight times as 
much data storage as a low-resolution display, as shown in Table 5-7. 

The double-high-resolution graphics mode interleaves the two 
high-resolution pages (Pages 1 and IX) in exactly the same way as 
80-column text mode interleaves the text pages: column 0 and all 
subsequent even-numbered columns come from the auxiliary page; 
column 1 and all subsequent odd-numbered columns come from the main 
page. 


5.5 Display Pages 
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Table 5-7. Video Display Page Locations 


Display 

Display Mode Page 

40-column text, 1 

low-resolution 2* 

graphics 

80-column text 1 

2 * 

High-resolution 1 

graphics 2 

Double-high- It 

resolution 2t 

graphics 


Lowest Address 

Highest Address 

$0400 

1024 

$07FF 

2047 

$0800 

2048 

$0BFF 

3071 

$0400 

1024 

$07FF 

2047 

$0800 

2048 

$0BFF 

3071 

$2000 

8192 

$3FFF 

16383 

$4000 

16384 

$5FFF 

24575 

$2000 

8192 

$3FFF 

16383 

$4000 

16384 

$5FFF 

24575 


* This is not supported by firmware; for instructions on how to switch pages, refer to 
Section 5.6. 
t See Section 5.3.3. 


5.6 Display Mode Switching 


Table 5-8 shows the reserved locations for the soft switches that control the 
different display modes. The column of the table labeledAcfiow indicates 
what to do to activate or read a switch setting: R means read the location, W 
means write anything to the location, R/W means read or write, and R7 
means read the location and then check bit 7. 

Table 5-9 lists the display modes that the firmware can set up 
automatically. In the 40-column modes, the contents of the standard I/O 
hooks KSW and CSW (Chapter 3) determine whether the enhanced video 
firmware features are available or not. The firmware also takes care of 
setting or clearing AltChar. 

Table 5-10 lists other display modes available but not supported by 
firmware. For modes that display Page 2 with the 80Col switch on, your 
program may have to turn 80Store off after the firmware has turned it on. 

Double-low-resolution shows on the display screen when HiRes is off and 
both 80Col and DHiRes are on. It is the low-resolution graphics equivalent of 
80-column text, and it uses the same map (Figure 5-6), giving you 48 rows of 
80 blocks. 
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The IOUDis ($C07E) switch must be on to allow you to use locations $C05E 
and $C05F to change DHiRes. The firmware in fact leaves it on— and your 
program should, too — unless it wants to use locations $C05E and $C05F to 
change mouse values (Chapter 9). 


Table 5-8. Display Soft Switches 


Name 

Action 

Hex 

Function 

AltChar 

W 

$C00E 

Off: Display text using primary character set 

AltChar 

W 

$C00F 

On: Display text using alternate character set 

RdAltChar 

R7 

$C01E 

Read AltChar switch (1 = on) 

80Col 

W 

$C00C 

Off: Display 40 columns 

80Col 

W 

$C00D 

On: Display 80 columns 

Rd80Col 

R7 

$C01F 

Read 80Col switch (1 = on) 

80Store 

W 

$C000 

Off: Cause Page2 on to select auxiliary RAM 

80Store 

W 

$0001 

On: Allow Page2 to switch main RAM areas 

Rd80Store 

R7 

$0018 

Read 80Store switch (1 = on) 

Page2 

R/W 

$C054 

Off: Select Page 1 

Page2 

R/W 

$0055 

On: Select Page IX (80Store on) or 2 

RdPage2 

R7 

$C01C 

Read Page2 switch (1 = on) 

TEXT 

R/W 

$0050 

Off: Display graphics or (if MIXED on) mixed 

TEXT 

R/W 

$0051 

On: Display text 

RdTEXT 

R7 

$C01A 

Read TEXT switch (1 = on) 

MIXED 

R/W 

$0053 

Off: Display only text or only graphics 

MIXED 

R/W 

$0054 

On: (If TEXT off) display text and graphics 

RdMIXED 

R7 

$C01B 

Read MIXED switch (1 = on) 


5.6 Display Mode Switching 
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Table 5-8 — continued. Display Soft Switches 


Name 

Action 

Hex 

Function 

HiRes 

R/W 

$0057 

Off: (If TEXT off) display low-resolution 
graphics 

HiRes 

R/W 

$0058 

On: (If TEXT off) display high-resolution or (if 
DHiRes on) double-high-resolution graphics 

RdHiRes 

R7 

$C01D 

Read HiRes switch (1 = on) 

IOUDis 

W 

$C07E 

On: Disable IOU access for addresses $0058 to 
$C05F; enable access to DHiRes switch* 

IOUDis 

W 

$C07F 

Off: Enable IOU access for addresses $0058 to 
$C05F; disable access to DHiRes switch* 

RdlOUDis 

R7 

$C07E 

Read IOUDis switch (1 = off)t 

DHiRes 

R/W 

$C05E 

On: (If IOUDis on) turn on 
double-high-resolution 

DHiRes 

R/W 

$C05F 

Off: (If IOUDis on) turn off 
double-high-resolution 

RdDHiRes 

R7 

$C07F 

Read DHiRes switch (1 = on)t 


* The firmware normally leaves IOUDis on. See also the following footnote, 
t Reading or writing any address in the range $C070-$C07F also triggers the paddle timer 
and resets VBLInt (Chapter 9). 


Table 5-9. Display Modes Supported by Firmware (Including Applesoft) 

Display Switches: 


Col/Res 

Type 

Page 

8OC0I 80 Store 

Page 2 

TEXT 

MIXED 

HiRes 

DHiRes 

40-column 

text 

1 

off 

off 

on 

Off 

off 

off 

80-column 

text 

1 

on * 


on 




low-res 

graphics 

1 

off 

off 

off 

off 

off 

off 

40/low 

mixed 

1 

off 

off 

off 

on 

off 


80/low 

mixed 

I 

on * 

off 

off 

on 

off 

off 

hi-res 

graphics 

1 

off 

off 

off 

off 

on 


hi-res 

graphics 

2 

off 

on 

off 

off 

on 


40/high 

mixed 

1 

off 

off 

off 

on 

on 


80/high 

mixed 

1 

on * 

off 

off 

on 

on 

off 


* 80Store is set by the firmware when 8OC0I is turned on. 
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Table 5-10. Other Display Modes 


Display Switches: 


Col/Res 

Type 

Page 

80CO1 

80Store 

Page2 

TEXT 

MIXED 

HiRes 

DHiRes 

40-column 

text 

2 

off 


on 

on 




80-column 


2 

on 

off 

on 

on 




low-res 

graphics 

2 

off 


on 

off 

off 

off 


40/low 

mixed 

2 

off 


on 

off 

on 

off 


80/low 

mixed 

2 

on 

off 

on 

off 

on 

off 

off 

dbl-low 

graphics 

1 

on 

* 

off 

off 

off 

off 

on 

dbl-low 

graphics 

2 

on 

off 

on 

off 

off 

off 

on 

80/dbl-low 

mixed 

1 

on 

* 

off 

off 

on 

off 

on 

80/dbl-low 

mixed 

2 

on 

off 

on 

off 

on 

off 

on 

40/high 

mixed 

2 

off 


on 

off 

on 

on 

off 

80/high 

mixed 

2 

on 

off 

on 

off 

on 

on 

dbl-high 

graphics 

1 

on 

* 

off 

off 

off 

on 

on 

dbl-high 

graphics 

2 

on 

off 

on 

off 

off 

on 

on 

80/ dbl-high 

mixed 

1 

on 

* 

off 

off 

on 

on 

on 

80/ dbl-high 

mixed 

2 

on 

off 

on 

off 

on 

on 

on 


* 80Store is set by the firmware when 8OC0I is turned on, and must be turned off to use the second 80-column or double-high-resolution 
page. This means that you cannot use firmware routines such as COut when displaying Page 2 modes not supported by firmware. 


For example, to switch to mixed 80-column and double-high-resolution 
display Page 1, you can use these instructions in your program: 


STA 

$C00D 

LDA 

$0054 

STA 

$ C 0 5 0 

STA 

$0053 

STA 

$0057 

STA 

$C07E 

LDA 

$ C 0 BE 


Turns on 8OC0I; firmware then turns on 80Store. 
Turns off Page2; you could also have done a STA. 
Turns off TEXT; that is, turns on graphics mode. 
Turns on MIXED; it works now that TEXT is off. 
Turns on HiRes; it works now that TEXT is off. 
Makes sure IOUDis is on so you can access DHiRes. 
Turns on DHiRes; it works now that IOUDis is on. 


5.7 Display Page Maps 


You should never have to store directly into display memory. Most 
high-level languages let you write statements that control the text and 
graphics displays. Similarly, if you are programming in assembly language, 
you should use the display features of the built-in I/O firmware. 


▲Warning 


Never call any firmware with 8OC0I on or with 80Store and Page2 both 
on. If you do, the firmware will not function properly. As a general rule, 
always leave Page2 off. 


5.7 Display Page Maps 
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For more details about the way the displays 
are generated, see Chapter 11. 


All the different display modes use the same basic addressing scheme: 
characters or graphics bytes are stored as rows of 40 contiguous bytes, but 
the rows themselves are not stored at locations corresponding to their 
locations on the display. Instead, the display address is transformed so that 
three rows that are eight rows apart on the display are grouped together and 
stored in the first 120 locations of each block of 128 bytes ($80 hex). For 
example, the first 128-byte block contains the data for rows 0, 8, and 16. 

The next 128-byte block contains data for rows 1, 9, and 17, and so on. 

The display memory maps are shown in Figures 5-5 through 5-9. For a full 
description of the way the Apple lie hardware handles display memory, see 
Section 11.9.2. 

High-resolution graphics data are stored in much the same way as text, but 
there are eight times as many bytes to store, because eight rows of dots 
occupy the same space on the display as one row of characters. 

The first 1024 bytes of the high-resolution display page contain the first row 
of dots from each of the 24 groups of eight rows of dots. The second 1024 
bytes of the high-resolution display page contain the second row of dots 
from each group of eight rows of dots, and so on for all eight rows of all the 
groups. This fills up the 8192 bytes of the high-resolution display page. 

The display maps show addresses only for each Page 1. To obtain addresses 
for text or low-resolution graphics Page 2, add 1024 ($0400); to obtain 
addresses for high-resolution Page 2, add 8192 ($2000). 

The 80-column display works a little differently. Half of the data are stored 
in the normal text Page 1 memory, and the other half are stored in the 
auxiliary memory text Page 1. The display circuitry fetches bytes from 
the same address in both memory areas simultaneously and displays them 
sequentially: first the byte from the auxiliary memory, then the byte from 
the main memory. The characters in the even-numbered columns of the 
display are stored (starting with column 0) in main memory, and the 
characters in the odd-numbered columns of the display are stored (starting 
with column 1) in main memory. 

To store display data in auxiliary memory, first turn on the 80Store soft 
switch by writing to location $C001. With 80Store on, the page-select switch 
Page2 selects between the portion of the 80-column display stored in Page 1 
of main memory and the portion stored in the auxiliary memory. To select 
auxiliary memory, turn the Page2 soft switch on by reading or writing at 
location $C055. 
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The double-high-resolution graphics display stores information in the same 
way as high-resolution graphics, except there is an auxiliary memory 
location as well as a main memory location corresponding to each address. 
The two sets of display information are interleaved in a manner similar to 
the interleaving of two 40-column displays to create an 80-column text 
display (Figure 5-9). 


Figure 5-5. Map of 40-Column Text Display 
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5.7 Display Page Maps 
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Figure 5-6. Map of 80-Column Text Display 
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Figure 5-7. Map of Low-Resolution Graphics Display 
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Figure 5-8. Map of High-Resolution Graphics Display 
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Figure 5-9. Map of Double-High-Resolution Graphics Display 
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5.8 Monitor Support for Video Display Output 


Table 5-11 summarizes the addresses and functions of the video display 
support routines the Monitor provides. Except for COut and COutl, which 
are explained in Chapter 3, these routines are described in the subsections 
that follow. 


Table 5-11. Monitor Firmware Routines 


Name 

Location 

Description 

ClrEOL 

$FC9C 

Clears to end of line from current cursor position 

C1EOLZ 

$FC9E 

Clears to end of line using contents of Y register as 
cursor position 

ClrEOP 

$FC42 

Clears to bottom of window 

ClrScr 

F832 

Clears the low-resolution screen 

ClrTop 

$F836 

Clears top 40 lines of low-resolution screen 

COut 

SFDED 

Calls output routine whose address is stored in CSW 
(normally COutl, Chapter 3) 

COutl 

$FDF0 

Displays a character on the screen (Chapter 3) 

CROut 

$FD8E 

Generates a carriage return character 

CROutl 

$FD8B 

Clears to end of line, then generates a carriage return 
character 

HLine 

$F819 

Draws a horizontal line of blocks 

HOME 

$FC58 

Clears the window and puts cursor in upper-left corner 
of window 

PLOT 

$F800 

Plots a single low-resolution block on the screen 

PrB12 

SF94A 

Sends 1 to 256 blank spaces to the output device whose 
address is in CSW 

PrByte 

$FDDA 

Prints a hexadecimal byte 

PrErr 

$FF2D 

Sends ERR and CONTROL-G to the output device 
whose output routine address is in CSW 

PrHex 

$FDE3 

Prints four bits as a hexadecimal number 

PrntAX 

$F941 

Prints contents of A and X in hexadecimal 
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Table 5-11 — continued. Monitor Firmware Routines 


Name 

Location 

Description 

SCRN 

$F871 

Reads color value of a low-resolution block on the 

screen 

SetCol 

$F864 

Sets the color for plotting in low-resolution 

VTabZ 

$FC24 

Sets cursor vertical position (setting CV at location $25 
does not change vertical position until a carriage 
return) 

VLine 

$F828 

Draws a vertical line of low-resolution blocks 


ClrEOL 

ClrEOL clears a text line from the cursor position to the right edge of the 
window. This routine destroys the contents of A and Y. 

CIEOLZ 

C1EOLZ clears a text line to the right edge of the window, starting at the 
location given by base address BASL indexed by the contents of the 
Y register. This routine destroys the contents of A and Y. 

ClrEOP 

ClrEOP clears the text window from the cursor position to the bottom of the 
window. This routine destroys the contents of A and Y. 

ClrScr 

ClrScr clears the low-resolution graphics display to black. If you call this 
routine while the video display is in text mode, it fills the screen with 
inverse-mode at-sign (@) characters. This routine destroys the contents 
of A and Y. 

ClrTop 

ClrTop is the same as ClrScr, except that it clears only the top 40 rows of 
the low-resolution display. 
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COut 


COut calls the current character output subroutine (Section 3.3.1). The 
character to be sent to the output device should be in the accumulator. COut 
calls the subroutine whose address is stored in CSW (locations $36 
and $37), usually the standard character output COutl. 

COutl 

COutl (Section 3.3.2) displays the character in the accumulator on the 
display screen at the current cursor position and advances the cursor. It 
places the character using the setting of the inverse mask (location $32). It 
handles these control characters: carriage return, line feed, backspace, and 
bell. When it returns control to the calling program, all registers are intact. 

CROut 

CROut sends a carriage return to the current output device. 

CROutl 

CROutl clears the screen from the current cursor position to the edge of the 
text window, then calls CROut. 

HLine 

HLine draws a horizontal line of blocks of the color set by SetCol on the 
low-resolution graphics display. Call HLine with the vertical coordinate of 
the line in the accumulator, the leftmost horizontal coordinate in the 
Y register, and the rightmost horizontal coordinate in location $2C. HLine 
returns with A and Y scrambled and X intact. 

HOME 

HOME clears the display and puts the cursor in the upper-left corner of the 
screen. 

PLOT 

PLOT puts a single block of the color value set by SetCol on the 
low-resolution display screen. Call PLOT with the vertical coordinate of the 
line in the accumulator, and its horizontal position in the Y register. PLOT 
returns with the accumulator scrambled, but X and Y intact. 
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PrBI2 


PrB12 sends from 1 to 256 blanks to the standard output device. Upon entry, 
the X register should contain the number of blanks to send. If X = $00, then 
PrBlank will send 256 blanks. 

PrByte 

PrByte sends the contents of the accumulator in hexadecimal to the current 
output device. The contents of the accumulator are scrambled. 

PrErr 

PrErr sends the word ERR, followed by a bell character (ASCII $07), to the 
standard output device. On return, the accumulator is scrambled. 

PrHex 

PrHex prints the lower nibble of the byte in the accumulator as a single 
hexadecimal digit. On return, the contents of the accumulator are 
scrambled. 

PrntAX 

PrntAX prints the contents of the A and X registers as a four-digit 
hexadecimal value. The accumulator contains the first byte printed, and 
the X register contains the second. On return, the contents of the 
accumulator are scrambled. 

SCRN 

SCRN returns the color value of a single block on the low-resolution display. 
Call it with the vertical position of the block in the accumulator and the 
horizontal position in the Y register. The block’s color is returned in the 
accumulator. No other registers are changed. 

SetCol 

SetCol sets the color used for plotting in low-resolution graphics to the value 
passed in the accumulator. The colors and their values are listed in 
Table 5-4. 
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VLine 


VLine draws a vertical line of blocks of the color set by SetCol on the 
low-resolution display. Call VLine with the horizontal coordinate of the line 
in the Y register, the top vertical coordinate in the accumulator, and the 
bottom vertical coordinate in location $2D. VLine returns with the 
accumulator scrambled. 


5.9 I/O Firmware Support for Video Display Output 


Apple lie video firmware conforms to the I/O firmware protocol described 
in Section 3.4.2. However, it does not support windows other than the full 
80-by-24 window in 80-column mode, and the full 40-by-24 window in 
40-column mode. 

The video (port 3) protocol table is shown in Table 5-12. 


Table 5-12. Port 3 Firmware Protocol Table 


Address 

Value 

Description 

$C30B 

$01 

Generic signature byte of firmware cards 

SC30C 

$88 

80-column card device signature 

$C30D 

$ii 

$C3ii is entry point of initialization routine (PInit). 

$C30E 

$rr 

$C3rr is entry point of read routine (PRead). 

$C30F 

$ww 

$C3ww is entry point of write routine (PWrite). 

$C310 

$ss 

$C3ss is entry point of the status routine (PStatus). 


Plnit 

PInit does the following: 

□ sets a full 80-column window 

□ sets 80Store ($C001) 

□ sets 80Col ($C00D) 

□ switches on AltChar ($C00F) 

□ clears the screen; places cursor in upper-left corner 

□ displays the cursor 
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PRead 


PRead reads a character from the keyboard and places it in the accumulator 
with the high bit cleared. It also puts a 0 in the X register to indicate 
IOResult = GOOD. 

P Write 

PWrite should be called after placing a character in the accumulator with 
its high bit cleared. PWrite does the following: 

□ turns the cursor off 

□ if the character in the accumulator is not a control character, turns the 
high bit on for normal display or off for inverse display, displays it at the 
current cursor position, and advances the cursor; if at the end of a line, 
does carriage return but not line feed 

□ carries out control functions as shown in Table 5-13 


Table 5-13. Pascal Video Control Functions 


CONTROL 

Hex 

Function 

E ore 

$05 

Turns cursor on (enables cursor display) 

Forf 

$06 

Turns cursor off (disables cursor display) 

Gorg 

$07 

Sounds bell (beeps) 

Horh 

$08 

Moves cursor left one column; if cursor was at 
beginning of line, moves it to end of previous line 

Jorj 

$0A 

Moves cursor down one row; scrolls if needed 

Kork 

SOB 

Clears to end of screen 

Lori 

$0C 

Clears screen; moves cursor to upper-left of screen 

Morm 

$0D 

Moves cursor to column 0 

Norn 

$0E 

Displays subsequent characters in normal video; 
characters already on display are unaffected 

Ooro 

$0F 

Displays subsequent characters in inverse video; 
characters already on display are unaffected 

Vor v 

$16 

Scrolls screen up one line; clears bottom line 

Wor w 

$17 

Scrolls screen down one line; clears top line 

Yory 

$19 

Moves cursor to upper-left (home) position on screen 
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Table 5-13 — continued. Pascal Video Control Functions 


CONTROL 

Hex 

Function 

Zorz 

$1A 

Clears entire line that cursor is on 

lor \ 

$1C 

Moves cursor right one column; if at end of line, does 
CONTROL-M 

} or ] 

$1D 

Clears to end of the line the cursor is on, including 
current cursor position; does hot move cursor 

* or 6 

$1E 

GOTOxy: Initiates a GOTOxy sequence; interprets the 
next two characters as x+32 and y+32, respectively 



$1F 

If not at top of screen, moves cursor up one line 


When PWrite has completed this, it 

□ turns the cursor back on (if it was not intentionally turned off) 

□ puts a 0 in the X register (IOResult = GOOD) and returns to the calling 
program. 

PStatus 

A program that calls PStatus must first put a request code in the 
accumulator: either a 0 (meaning “Ready for output?”) or a 1 (meaning “Is 
there any input?”). PStatus returns with the reply in the carry bit: 0 (no) or 
1 (yes). If the request was not 0 or 1, PStatus returns with a 3 in the 
X register (IOResult = ILLEGAL OPERATION); otherwise, PStatus returns 
with a 0 in the X register (IOResult = GOOD). 


no 
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Chapter 6 


Disk Input and Output 
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UniDisk 3.5 


The Apple lie supports both its built-in disk drive and an optional external 
514-inch drive; both drives use single-sided, 143K-capacity, 35-track, 
16-sector format. Table 6-1 summarizes disk I/O port characteristics. 

A new version of the Apple lie supports UniDisk 3.5, a 314-inch, 
double-sided, 800K-capacity disk drive. The UniDisk 3.5 is an intelligent 
device: the Apple lie does not have to do all the work of controlling it 
when reading or writing information on the disk. Programs make requests 
through the operating system to the intelligent device, the device works 
on the request, and, when finished, responds to the operating system. 

The Protocol Converter in the firmware of the new version of the 
Apple lie, described in this chapter, provides a way of communicating 
with UniDisk 3.5. The Protocol Converter communicates through the 
Apple He’s disk I/O port and allows intelligent devices to be daisy 
chained, which means that the first device is plugged into the disk port, 
the next device is plugged into the first device, and so on. 

The Protocol Converter can handle up to 127 devices in a daisy chain, but 
the Apple lie sets a much lower limit, since it can provide power to only a 
few devices at one time. The Disk lie is still supported, as long as it is the 
last device in the daisy chain. 


Table 6-L Disk I/O Port Characteristics 

Port number: 

Commands: 

Initial characteristics: 

Hardware location: 

$C0E0-EF 

Monitor firmware routines: 

I/O firmware entry points: 

Use of screen holes: 


I/O port 6 drive 1 (built-in drive) 

I/O port 6 drive 2 (external drive) 

IN#6 or PR#6 

CALL -151 (to get to the Monitor 
from BASIC), then 6 CONTROL-K or 
6 CONTROL-P 

All resets except | control H~reset| 
with a valid reset vector eventually 
pass control to the built-in disk drive. 


Reserved 

None 

$C600 (port 6) 

Port 6 main and auxiliary memory 
screen holes are reserved. 
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The external disk drive connector is 
described in Section 11.10. 


UniDisk 3.5 


The disk I/O firmware resides in the $C600 address space. It supports the 
built-in drive as if it were slot 6 drive 1, and the external drive as if it were 
slot 6 drive 2. If disk startup is unsuccessful, the firmware shuts off the disk 
drive motor and displays the message Check Disk Drive on the display 
screen. 

For Apple lie’s that support UniDisk 3.5, disk startup is tried with both 
the built-in drive and the first device connected to the disk I/O port. If 
both tries fail, the message c h e c k Disk Drive appears on the display 
screen. 


6.1 Startup 

The Apple lie has two ways to start up— a cold start and a warm start. A 
cold start clears the machine’s memory and tries to load an operating 
system from disk. A warm start stops the current program that is running 
and leaves the machine in Applesoft with memory and programs intact. 

A cold start can be initiated by any of the following: 

□ turning the machine on 

□ pressing fc5~] - | control H reset l 

□ issuing a reboot command from the Monitor, BASIC, or a program 

□ pressing | control | - | reset 1 , if a valid reset vector does not exist 

The cold-start routine first sets a number of soft switches (see Chapter 2) 
and then passes control to the program entry point at $C600. This code 
turns on the internal drive motor, recalibrates the read/write head at track 
0, then reads sector 0 from that track. The sector contents are loaded into 
memory starting at address $0800; then program control passes to $0801. 
The program loaded depends on the operating system or application 
program on the disk. 

To restart the system from BASIC, issue a PR#6 command; from Monitor 
command mode, issue 6 CONTROL-P; and use JMP $C600 from a 
machine-language program. 

A warm start begins when you press | control H reset | , if a valid reset 
vector exists. Normally, a warm start leaves you in BASIC with memory 
unchanged. If a program has changed the reset vector the system won’t do a 
warm start; instead, it may do any number of things. Usually it either does a 
cold start or it beeps or does nothing, leaving you in the currently executing 
program. 


6.1 Startup 
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Original lie 


UniDisk 3.5 


UniDisk 3.5 


A block device reads or writes information 
in organized groups called blocks, which 
are typically 512 bytes in size. A disk drive 
is a block device. Compare this with a 
character device, which reads or writes 
data sequentially. Printers, modems, and 
plotters are character devices. 


6.2 External Drive Startup 


You might need to start your Apple lie from an external drive if, for 
example, the built-in drive fails. The way this works depends on the type of 
Apple lie you have and the software you want to run. 

The ProDOS operating system (but not the DOS or Pascal operating 
systems) supports startup using the external Disk He drive. This ProDOS 
feature makes it possible to start the Apple He with a diagnostic program 
in the event that the built-in drive does not work. 

To restart from the Monitor using the external Disk He, insert a ProDOS 
disk in the external drive, then start the Monitor by typing call -151 
and pressing [7] I control H ~p~|. 

To restart from BASIC using the external Disk lie, insert a ProDOS disk in 
the external drive, then type pr# 7 . 

External drive startup using PR#7 works on the original Apple lie only 
with ProDOS-based programs. It does not work with Pascal 1.0 or later 
versions, or with DOS 3.3. 

The Apple lie that supports UniDisk 3.5 can use PR#5 to start up from an 
external Disk He or from the first intelligent drive connected to the 
Protocol Converter through the disk port. Starting up from an external 
intelligent drive works from ProDOS or Pascal 1.3, but not from DOS or 
versions of Pascal earlier than 1.3. 


6.3 The Protocol Converter 

The rest of this chapter applies only to the version of the Apple lie that 
supports UniDisk 3.5. 

The rest of this chapter is about the Protocol Converter, which is a set of 
assembly-language routines used to support external I/O devices, such as 
UniDisk 3.5. To ProDOS and Pascal 1.3, the Protocol Converter appears to be 
a block device. 

The following topics are discussed: 

□ how to locate the Protocol Converter 

□ how to issue a call to the Protocol Converter 

□ how to use each call 

□ the parameters required for each call 

□ possible errors codes returned for each call 

□ the possible causes of the errors 
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At the end of this chapter is an example of an assembly-language program 
that uses a Protocol Converter call. 


6.3.1 Locating the Protocol Converter 


The Protocol Converter code in the Apple He’s firmware always begins at 
address $C500. To ensure compatibility of your programs with the Apple He, 
however, your Protocol Converter routines should always begin with a 
search for the Protocol Converter. Your program can identify the Protocol 
Converter by finding the following bytes: 

$Cn01 = $20 
$Cn03 = $00 
$Cn05 = $03 
$Cn07 = $00 

where n can be an integer from 1 to 7. The Protocol Converter entry point is 
then found at address $Cn00 + ($CnFF) + 3, where ($CnFF) refers to the 
value of the byte located at $CnFF. The sample program at the end of this 
chapter illustrates such a search. 


MLI calls: See the ProDOS Technical 
Reference Manual, Chapter 4. 


6.3.2 Issuing a Call to the Protocol Converter 


Protocol Converter calls are coded like ProDOS Machine Language Interface 
(MLI) calls: the program executes a JSR to a dispatch routine at address 
$C500 + ($C5FF) + 3, where ($C5FF) refers to the value of the byte located 
at $C5FF. 

The Protocol Converter call number and a two-byte pointer to the call’s 
parameter list must immediately follow the call. Here is an example of a call 
to the Protocol Converter: 

iwmcall jsr dispatch Calls PC command dispatcher 
dfb CmdNum Specifies the command type 

dw cmd l i s t 2-byte (low, high) pointer to parameter 

list 

bcs error Sets carry on an error 
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The command number (CmdNum) defines which Protocol Converter call 
you want to make. Most Protocol Converter calls include a two-byte pointer 
to a parameter list. The parameter list can contain information to be used by 
the call, or can provide space for information to be returned by the call. The 
length and content of the parameter list depend on the call being made. The 
format of each Protocol Converter call’s parameter list is described in 
Section 6.4. 

When the call has finished, the program resumes execution at the 
statement following the pointer to the parameter list. In the example above, 
the DFB and DW statements are skipped, and execution resumes with the 
BCS statement. If the call is successful, the C flag (in the processor status 
register) is cleared (0), and the accumulator (the A register) is cleared to all 
Os. If the call is unsuccessful, the C flag is set (1), and the error code is 
placed in the A register. After the Protocol Converter call, the contents of 
the 65C02’s registers are as follows: 


Register: 

Processor Status 


X 

Y 

A 

PC 

s 

Bit: 

N Z 

c 

D 

V I 

B 






Successful call: 

X X 

0 

0 

X u 

u 

X 

X 

0 

JSR+3 

u 

Unsuccessful 











call: 

X X 

l 

0 

X u 

u 

X 

X 

Error 

JSR+3 

u 


x = undefined, except in cases where index information is returned in X and Y 
u = unchanged 


6.3.3 Cautions 


Reading and writing to RAM: See Section 
2.4. 


You must observe the following cautions when using the Protocol 

Converter, or your program will crash: 

□ Leave space on the stack for the Protocol Converter. The Protocol 
Converter requires up to 35 bytes of stack space. Be sure you take this 
into account when calculating the stack space used by your program. If 
you don’t do this, you program will fail if it tries to access data that used 
to be on the stack. 

□ Be sure that all RAM that you intend the Protocol Converter to access is 
both read-enabled and write-enabled. The Protocol Converter must be 
able to read from the RAM after writing to it, to obtain a checksum. 
Failure to observe this rule results in an error (BusErr $06). 

□ Don’t pass data to or from the Protocol Converter through any zero page 
locations. Some of these locations are reserved for temporary storage of 
data by the Protocol Converter, and your data will get changed. 
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6.4 Descriptions of the Protocol Converter Calls 

Calls to the Protocol Converter are used 

□ to obtain status information about a device 

□ to reset a device 

□ to format the medium in a device 

□ to read from a device 

□ to write to a device 

□ to send control information to a device. 


The Protocol Converter calls, in command-number sequence, are: 

STATUS ($00) Returns status information about a particular 

device, including general status (character or 
block device, read or write protection, format 
allowed, device on line); the device control 
block (set with the CONTROL call); the 
device newline status (character devices 
only); and device-specific information 
(number of blocks, ID string, device name, 
device type, device firmware version). 

READ BLOCK ($01) Reads one 512-byte block from a disk device, 

and writes it to memory. 

WRITE BLOCK ($02) Writes one 512-byte block from memory to a 

disk device. 


FORMAT ($03) 
CONTROL ($04) 


INIT ($05) 


OPEN ($06) 


Prepares all blocks on a block device for 
reading and writing. 

Controls some device functions, including 
soft resets, setting the device control block 
(which controls global aspects of the device’s 
operating environment), setting newline 
status (character devices only), and device 
interrupts. Several CONTROL calls are 
device-specific. 

Resets all resident devices. A global reset is 
done automatically on startup or system 
resets from the keyboard; an application 
should never have to reset all devices. 

Prepares a character device for reading or 
writing. 
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CLOSE ($07) 


Tells a character device that a sequence of 
reads or writes is over. 


READ ($08) 


Reads a specified number of bytes from a 
specified device. 


WRITE ($09) 


Writes a specified number of bytes from 
memory to a specified device. 


The following sections describe each Protocol Converter call, including the 
command number, the parameter list, and error codes. The calls are 
discussed in command-number order in this format: 

Command Name: The name used to identify the call. 

Command Number: A hexadecimal number that specifies which call is 
being made to the Protocol Converter. 

Parameter List: A list of required call parameters. 

General Description: What the call does and what you use it for. 

Parameter Descriptions: A description of each parameter and the data it 
refers to. When a parameter refers to a status or control code, the meaning 
of each code number is discussed. 

Possible Errors: A list of the error codes that can be returned by this call. 
A complete list of Protocol Converter error codes is included at the end of 
this chapter. 
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6.4.1 STATUS 


Command Number $00 

Parameter List $03 (parameter count) 

Unit number 

Status list pointer (low byte, high byte) 

Status code 

The STATUS call returns status information about a specified device. The 
type of information returned is determined by the device and its status-code 
parameter. The status list pointer defines where the status information is 
returned to. 

STATUS returns the number of bytes of status information that it generates 
in the X and Y registers, the low byte of this number in the X register, and 
the high byte in the Y register. 


Parameter Descriptions 

Parameter 

Count 

1-byte value 3 for this call. 

Unit Number The Protocol Converter assigns each device a unique 

1-byte value number during initialization (on startup and cold 

reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
chain. 


Important! 


You can get the status of the Protocol Converter itself if you use a unit 
number of $00 and a status code of $00 in a STATUS call (see the 
discussion beginning “Status code = $00,” below). 


Status List 
Pointer 

2-byte value 


Points to the buffer to which the status is to be 
returned. The length required for the buffer varies 
depending on the status request being made. 
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Status Code Indicates what kind of status request is being made. 
1-byte value Status codes are in the range $00-$FF, as follows: 

Code Status Returned 

$00 Return device status 

$01 Return device control block (DCB) (not supported 
by UniDisk 3.5) 

$02 Return newline status (character devices only) 
(not supported by UniDisk 3.5) 

$03 Return device information block (DIB) 

$05 Return UniDisk 3.5 status 


Status code = $00 returns a device status consisting of four bytes. The first 
is the general status byte, with the following format: 

Bit Description 

7 0 = character device, 1 = block device 

6 1 = write allowed 

5 1 = read allowed 

4 1 = device on line or disk in drive 

3 0 = format allowed 

2 0 = medium write protected (block devices only) 

1 1 = device currently interrupting 

0 1 = device currently open (character devices only) 


If the STATUS call is for a block device, the next three bytes (low byte 
first) are the size in 512-byte blocks. The maximum size is 16 milli on 
($FFFFFF) blocks (about 8 gigabytes). If the call is for a character device, 
these three bytes must be set to 0. 

A STATUS call with status code = $00 and unit number = $00 returns the 
status of the Protocol Converter itself. In this case, the status list consists of 
eight bytes, as follows: 


STAT_LIST DFB Number_Devi ces 

DFB I nter rupt_Statu5 

DFB 

DFB 

DFB 

DFB 

DFB 

DFB 


Devices hooked to PC 

Bit 6 clear = interrupt sent 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 
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Newline read mode: See Chapter 4 in the 
ProDOS Technical Reference Manual. 


The Number-Devices byte returns the total number of intelligent devices 
attached to the Protocol Converter. The Interrupt— Status byte is a copy of 
the asynchronous communications interface adapter (ACIA) status register 
at the time of the interrupt, and is used to indicate that a device requires 
interrupt servicing. If the sixth bit of this byte equals 0, one or more devices 
in the Protocol Converter bus daisy chain must be serviced; your interrupt 
handler must poll each device on the chain to determine which ones. 

About Interrupts: Devices that require interrupt servicing must use the 
EXTINT line on the Apple He’s external disk port connector to be 
supported by the Protocol Converter. 

For example, UniDisk 3.5 does not support this line, and so cannot 
generate interrupts to the Protocol Converter. See Section 6.4.5 for 
instructions on enabling Protocol Converter interrupts. See Appendix E 
for more information about programming with interrupts. 

Status code = $01 returns the device control block (DCB). The DCB is used 
to control various operating characteristics of a device, and is device 
dependent. Each device has a default DCB, which can be altered with a 
CONTROL call. The first byte (the count byte) gives the number of bytes in 
the control block ( not including the count byte), so the length never 
exceeds 256 bytes (257 including the count byte). Note that UniDisk 3.5 has 
no DCB, and returns an error (BadCtl $21) in response to this call. 

Status code = $02 returns newline status. Newline status applies only to 
character devices. A status code = $02 passed to a block device returns a 
BadCtl ($21) error. 

Status code = $03 returns the device information block (DIB). The device’s 
information block identifies the device, its type, and various other 
attributes. The returned status list has the following form: 


ST AT_L I ST DFB 

Device_Statbyte1 

Same as byte 1 in status 
code = 0 

DFB 

Device_Size_Lo 

Number of blocks (block 
device) 

DFB 

Device_Size_Med 

Number of blocks (middle 
byte) 

DFB 

Device_Si ze_Hi 

Number of blocks (high 
byte) 

DFB 

ID_String_Length 

Length in bytes (16 max.) 

ASC 

'{device name)' 

7-bit ASCII, uppercase, 
padded with spaces, 8th 
bit always=0 (16 bytes) 

DFB 

Device_Type_Code 


DFB 

Device_Subtype_Code 

DW 

Version 

Device firmware version 
number 
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Status code = $05 returns the UniDisk 3.5 status. This call allows a 
diagnostic program to get more detailed information about the cause of a 
read or write error, and to examine the contents of the 65C02’s registers 
after a CONTROL call with control code = $05 (see Section 6.4.5). The 
returned status list has this form: 


STAT_L I ST DFB 

$00 


DFB 

Error 

Soft Error byte (see below) 

DFB 

Retries 

Number of retries (see below) 

DFB 

$00 


DFB 

A_Va 1 ue 

Acc value after a CONTROL EXECUTE 
call 

DFB 

X_Va 1 ue 

X value after EXECUTE 

DFB 

Y_Va 1 ue 

Y value after EXECUTE 

DFB 

P_Va 1 ue 

Processor status value after EXECUTE 


The Error byte returned by a STATUS call with status code = $05 contains 
the following bits: 


Bit Description 

7 0 

6 0 

5 1 = address field mark or checksum error 

4 1 = data field checksum error 

3 1 = data field bitslip mark mismatch 

2 1 = seek error; unexpected track value found 

in address field 

1 0 

0 0 


The Retries byte returned by a STATUS call with status code = $05 
specfies the number of address fields that had to be passed before the 
operation was completed. This information could be used, for example, to 
determine the number of passes necessary to read a data field correctly: If 
Retries is found to be greater than the number of sectors on the target track, 
then more than one pass was required. 

The last four bytes of the status list are set only after a CONTROL call with 
control code = $05, and are 0 after any other call (STATUS calls do not 
clear the status bytes). 
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Possible Errors 


The following errors can be returned by the STATUS call: 


$01 BadCmd 

$04 BadPCnt 

$06 BusErr 

$21 BadCtl 

$30-$3F 


An unimplemented command was issued 
Bad call parameter count 
Communications error 
Invalid status code 
Device-specific errors 


6.4.2 READ BLOCK 

Command Number $01 

Parameter List $03 (parameter count) 

Unit number 

Data buffer (low byte, high byte) 

Block number (low byte, mid byte, high byte) 

The READ BLOCK call reads one 512-byte block into memory from the 
block device specified by the unit-number parameter. The block of data is 
placed in a buffer starting at the address specified by the data-buffer 
parameter. 

Parameter Descriptions 

Parameter 

Count 

1-byte value 3 for this call. 

Unit Number The Protocol Converter assigns each device a unique 
1-byte value number during initialization (on startup and cold 

reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 
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Data Buffer Points to the buffer into which the data are read. The 
2-byte value buffer must be 512 or more bytes in length. 


Block Number The logical address of a block of data to be read. There 
3-byte value is no general connection between block numbers and 

the layout of tracks and sectors on the disk. The 
translation from logical to physical blocks is 
performed by the device. (The most significant byte is 
0 for all devices currently in use.) 


Possible Errors 

The following errors can be returned by the READ BLOCK call: 


$01 

BadCmd 

An unimplemented command was issued 

$04 

BadPCnt 

Bad call parameter count 

$06 

BusErr 

Communications error 

$27 

IOError 

I/O error 

$28 

NoDrive 

No device connected 

$2D 

BadBlock 

Invalid block number 

$2F 

OffLine 

Device off-line or no disk in drive 


6.4.3 WRITE BLOCK 

Command Number $02 

Parameter List $03 (parameter count) 

Unit number 

Data buffer (low byte, high byte) 

Block number (low byte, mid byte, high byte) 

The WRITE BLOCK call writes one 512-byte block from memory to the disk 
device specified by the unit-number parameter. The block in memory starts 
at the address specified by the data-buffer parameter. 
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Parameter Descriptions 


Parameter 

Count 

1-byte value 3 for this call. 

Unit Number The Protocol Converter assigns each device a unique 
1-byte value number during initialization (on startup and cold 

reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 


Data Buffer Points to the buffer from which the data are to be 

2-byte value written. 


Block Number The logical address of a block of data to be written. 

3-byte value There is no general connection between block 

numbers and the layout of tracks and sectors on the 
disk. The translation from logical to physical blocks is 
performed by the device. (The most significant byte is 
0 for all devices currently in use.) 


Possible Errors 

The following errors can be returned by the WRITE BLOCK call: 


$01 

BadCmd 

An unimplemented command was issued 

$04 

BadPCnt 

Bad call parameter count 

$06 

BusErr 

Communications error 

$27 

IOError 

I/O error 

$28 

NoDrive 

No device connected 

$2B 

NoWrite 

Disk write protected 

$2D 

BadBlock 

Invalid block number 

$2F 

OffLine 

Device off-line or no disk in drive 
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6.4.4 FORMAT 


Command Number $03 

Parameter List $01 (parameter count) 

Unit number 

The FORMAT call prepares all blocks on the recording medium of a block 
device for reading and writing. The formatting done by this call is specific 
to each device and is not linked to any operating system; for example, 
bitmaps and catalogs are not written by this call. 

Parameter Descriptions 

Parameter 

Count 

1-byte value 1 for this call. 

Unit Number The Protocol Converter assigns each device a unique 
1-byte value number during initialization (on startup and cold 

reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 


Possible Errors 

The following errors can be returned by the FORMAT call: 


$01 

BadCmd 

An unimplemented command was issued 

$04 

BadPCnt 

Bad call parameter count 

$06 

BusErr 

Communications error 

$27 

IOError 

I/O error 

$28 

NoDrive 

No device connected 

$2B 

NoWrite 

Disk write protected 

$2F 

Offline 

Device off-line or no disk in drive 
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6.4.5 CONTROL 


Important! 


Important! 


Command Number $04 

Parameter List $03 (parameter count) 

Unit number 

Control list (low byte, high byte) 

Control code 

The CONTROL call sends control information to the device. The 
information can be of a general nature (such as resets or interrupts), or 
device-specific (such as Download to UniDisk 3.5 RAM). 

A CONTROL call to unit number $00 sends control information to the 
Protocol Converter itself. See the discussions of control code = $00 and 
control code = $01, below. 


Parameter Descriptions 

Parameter 

Count 

1-byte value 3 for this call. 

Unit Number The Protocol Converter assigns each device a unique 

1-byte value number during initialization (on startup and cold 

reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. Use a unit number of $00 in the 
CONTROL call to send control information to the 
Protocol Converter itself. 


Control List Points to the buffer containing the control information. 

2-byte value The first two bytes (the count bytes, low byte first) of 

the control list specify the number of bytes in the list 
( not including the count bytes); the remainder of the 
list contains the control information passed to the 
device. 


Every CONTROL call must have a control list; if no control information is 
being passed, then the control list consists of the count bytes only: 

CTRL-L I ST DW $00 
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Control Code The number of the control request being made. 

1-byte value Control codes are in the range $00-$FF. The following 
requests are not device specific: 

Code Control Function 

$00 Reset the device 

$01 Set device control block (DCB) 

$02 Set newline status (character devices only) 

$03 Service device interrupt 


Control requests to unit number $00 are sent to the 
Protocol Converter itself: 

Code Control Function 

$00 Enable interrupts from Protocol Converter 
$01 Disable interrupts from Protocol Converter 


Specific devices may respond to some or all of these 
additional control requests: 

Code Control Function 

$04 Eject disk 
$05 Run a 65C02 subroutine 

$06 Set download address 

$07 Download to device RAM 


Control code = $00 performs a warm reset of the device and generally 
returns “housekeeping” values to some reset value. The control list for this 
call is device dependent. 

The control list for this call for UniDisk 3.5 devices is: 

ctrl_l i st dw $00 No parameters are passed. 

A CONTROL call with control code = $00 and unit number = $00 enables 
interrupts from the Protocol Converter. This informs the firmware that 
external interrupts are possible, and directs it to call the user’s interrupt 
handler if an interrupt occurs. It also turns on the ACIA for port 1. 

When the user’s interrupt handler identifies an external interrupt, you can 
determine if it came from the Protocol Converter by making a STATUS call 
with unit number = $00 and control code = $00 (see Section 6.4.1). See 
Appendix E for more information on handling interrupts. 
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Newline read mode: See Chapter 4 in the 
ProDOS Technical Reference Manual. 


▲Warning 


Control code = $01 alters the contents of the device control block (DCB). 
The DCB is used to set global aspects of a device’s operating environment. 
Each device has a default setting for the DCB, set on initialization. Since the 
length of the DCB is device dependent, you should first read in the DCB 
with the STATUS call, then alter the bits of interest, and finally, use the 
same byte string as the control block for the CONTROL call. The first byte 
(the count byte) of the DCB gives the number of bytes in the control block 
( not including the count byte), so the length never exceeds 257 bytes, 
including the count byte. 

Note that because UniDisk 3.5 has no DCB, a Set DCB CONTROL call to 
UniDisk 3.5 returns an error (BadCtl $21). 

A CONTROL call with control code = $01 and unit number = $00 disables 
interrupts from the Protocol Converter. This call turns off the ACIA for port 
1 and sets the least significant bit of the ACIA control register to 0. 

Control code = $02 sets a character device to newline enabled or newline 
disabled. 

Control code = $03 sends a device service interrupt. This code is to be used 
as needed for interrupt-driven devices. 

Control code = $04 ejects a disk. This code is to be used for devices that 
support an auto-eject feature. This code causes UniDisk 3.5 to auto-eject a 
disk. There are no parameters in the control list, and no errors are returned 
if the disk ejected correctly or there was no disk in the drive. Error code $27 
(IOError) is returned if the eject failed— that is, if a disk is still in the drive. 
The control list for UniDisk 3.5 is the following: 

ctrl_l i st dw $00 No parameters are passed. 

Control codes $05 and higher are reserved; use of some of these codes can 
cause your system to crash. 


Possible Errors 

The following errors can be returned by the CONTROL call: 


$01 BadCmd 

$04 BadPCnt 

$06 BusErr 

$21 BadCtl 

$22 BadCtlParm 

$30-$3F 


An unimplemented command was issued 
Bad call parameter count 
Communications error 
Invalid control code 
Invalid parameter list 
Device-specific errors 
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6.4.6 INIT 


Command Number $05 

Parameter List $01 (parameter count) 

$00 (unit number) 

The INIT call resets all intelligent devices attached to the Protocol 
Converter. The Protocol Converter goes through an initialization sequence, 
cold-resetting all devices and sending each its unit number. This call is 
made automatically on startup; an application should never have to make 
this call. 

Parameter Descriptions 

Parameter 

Count 

1-byte value 1 for this call. 

Unit Number 

1-byte value The unit number used in this call is always $00. 

Possible Errors 


The following errors can be returned by the INIT call: 


$01 

BadCmd 

An unimplemented command was issued 

$04 

BadPCnt 

Bad call parameter count 

$06 

BusErr 

Communications error 

$28 

NoDrive 

No device connected 
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6.4.7 OPEN 


Command Number $06 

Parameter List $01 (parameter count) 

Unit number 

The OPEN call prepares a character device for reading or writing. 

Note that since UniDisk 3.5 is a block device, it does not accept this call. An 

attempt to use an OPEN call with UniDisk 3.5 will result in an error 

(BadCmd $01). 

Parameter Descriptions 

Parameter 

Count 

1-byte value 1 for this call. 

Unit Number The Protocol Converter assigns each device a unique 

1-byte value number during initialization (on startup and cold 

reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 


Possible Errors 

The following errors can be returned by the OPEN call: 


$01 

BadCmd 

An unimplemented command was issued 

$04 

BadPCnt 

Bad call parameter count 

$06 

BusErr 

Communications error 

$28 

NoDrive 

No device connected 

$2F 

OffLine 

Device off-line or no disk in drive 
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6.4.8 CLOSE 


Command Number $07 

Parameter List $01 (parameter count) 

Unit number 

The CLOSE call tells a character device that a sequence of reads or writes is 
over. 

Note that since UniDisk 3.5 is a block device, it does not accept this call. An 
attempt to use a CLOSE call with UniDisk 3.5 will result in an error 
(BadCmd $01). 

Parameter Descriptions 

Parameter 

Count 

1-byte value 1 for this call. 

Unit Number The Protocol Converter assigns each device a unique 
1-byte value number during initialization (on startup and cold 

reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 


Possible Errors 

The following errors can be returned by the CLOSE call: 


$01 

BadCmd 

An unimplemented command was issued 

$04 

BadPCnt 

Bad call parameter count 

$06 

BusErr 

Communications error 

$28 

NoDrive 

No device connected 

$2F 

Offline 

Device off-line or no disk in drive 
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6.4.9 READ 


Command Number $08 

Parameter List $04 (parameter count) 

Unit number 

Buffer pointer (low byte, high byte) 

Byte count (low byte, high byte) 

Address pointer (low byte, mid byte, high byte) 

The READ call reads into memory the number of bytes specified by the 
byte-count parameter. The bytes are placed in a buffer starting at the 
address specified by the buffer-pointer parameter. 


Parameter Descriptions 

Parameter 

Count 

1-byte value 4 for this call. 

Unit Number The Protocol Converter assigns each device a unique 

1-byte value number during initialization (on startup and cold 

reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 


Buffer Pointer Points to the buffer into which the data is read. The 
2-byte value buffer must be large enough to contain the number of 

bytes requested by the byte-count parameter. 


Byte Count 

2-byte value Specifies the number of bytes to be transferred. 


Address 

Pointer 

3-byte value 


Specifies the address to start reading from. The 
meaning of this parameter depends on the device 
being read. 
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Possible Errors 


The following errors can be returned by the READ call: 


$01 

BadCmd 

An unimplemented command was issued 

$04 

BadPCnt 

Bad call parameter count 

$06 

BusErr 

Communications error 

$27 

IOError 

I/O error 

$28 

NoDrive 

No device connected 

$2D 

BadBlock 

Invalid block number 

$2F 

Offline 

Device off-line or no disk in drive 

6.4.10 

WRITE 


Command Number 

$09 

Parameter List 

$04 (parameter count) 

Unit number 

Buffer pointer (low byte, high byte) 

Byte count (low byte, high byte) 

Address pointer (low byte, mid byte, high byte) 


The WRITE call writes from memory the number of bytes specified by the 
byte-count parameter to the specified unit. The bytes in memory start at the 
address indicated by the buffer-pointer parameter. The meaning of the 
address pointer depends on the type of device (see parameter descriptions). 

Parameter Descriptions 

Parameter 

Count 

1-byte value 4 for this call. 

Unit Number The Protocol Converter assigns each device a unique 
1-byte value number during initialization (on startup and cold 

reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 
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Buffer Pointer Points to the buffer from which the data is to be 
2-byte value written. 

Byte Count 

2-byte value Specifies the number of bytes to be transferred. 


Address Specifies the address to start writing from. The 

Pointer meaning of this parameter depends on the device 

3-byte value being written to. 


Possible Errors 

The following errors can be returned by the WRITE call: 


$01 

BadCmd 

An unimplemented command was issued 

$04 

BadPCnt 

Bad call parameter count 

$06 

BusErr 

Communications error 

$27 

IOError 

I/O error 

$28 

NoDrive 

No device connected 

$2D 

BadBlock 

Invalid block number 

$2F 

Offline 

Device off-line or no disk in drive 
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0000: 

0000 : 

0000 : 

0000: 

0000 : 

0000 : 

0000 : 

0000 : 

0000 : 

0000: 

0000 : 

0000 : 

0000 : 

0 0 0 0 : 

0000 : 

0000 : 

0000 : 

0000 : 

0000: 

0 0 0 0 : 

0000: 

0000 : 

0000 : 

0000 : 

0000 : 

0000 : 

0000 : 

0000 : 

0300 : 

0300: 

0300: 

0300 : 

0300: 

0300:2 

0303:1 

0305: 

0305: 

0305: 

0305:2 
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03 


03 


Here is an example of a program that issues a STATUS call to the Protocol 
Converter to obtain information about a device. 

The code for the Protocol Converter in the version of the Apple lie that 
supports UniDisk 3.5 always begins at address $C500; however, to ensure 
compatibility with the Apple He, your programs should always do a search 
for the Protocol Converter, as in this example. 



1 

# 




2 

■» 




3 

# 




4 

* 

This example 

shows how to find 


5 

* 

and use a PC 

interface. A search 


6 

* 

is made for 

a PC, and when one is 


7 

# 

found, a vector is set up which 


8 

# 

points to the PC entry. Then a 


9 

# 

Device Information Block STATUS call 


10 

* 

is made, and 

if successful, the name 


1 1 

* 

string embedded in the DIB is output 


12 

* 

to the screen. Only the first device 


13 

* 

in the chain 

i 5 accessed. 


14 

# 




15 

* 




16 


MSB 

□ N 


17 

* 




18 

* 



0006 

19 

ZPTempL equ 

$0006 ;Temporary zero 


20 



page storage 

0007 

21 

ZPTempH equ 

$0007 


22 

* 



FDED 

23 

COut equ 

$FDED ; Console output 

FD8E 

24 

CROut equ 

$ FD8E ; Carriage retur 


25 

* 



0000 

26 

StatusCmd equ 

0 


27 

* 




28 

«- 



0300 

29 


org 

$300 


30 





31 

# 

Find a Protocol Converter in one of th( 


32 

«■ 

5 1 o t 5 . 



33 




t 

34 


J sr 

FindPC 

0321 

35 


be 5 

Error 


36 

* 




37 

* 

Now make the DIB call to the first quy 


38 





39 


i sr 

Di spa t ch 
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0308: 

00 



40 

dfb 

S ta t usCmd 

0309: 

6A 

03 


41 

dw 

DParms 

030B : 

B0 

14 

0321 

42 

be 5 

Error 

030D : 




43 

* 


030D : 




44 

* Got the DIB; now print the name string 

030D : 




45 

* 


030D : 

A2 

00 


46 

ldx 

#0 

030F 



030F 

47 

morechars equ 

«• 

030F 

BD 

74 

03 

48 

1 da 

D I BName , x 

0312: 

09 

80 


49 

ora 

#$80 ;COut wants high 

0314 




50 

* 

Bit set 

0314 




51 

* 


0314 

20 

ED 

FD 

52 

j 5r 

COut 

0317 

E8 



53 

i nx 


0318 

EC 

73 

03 

54 

cpx 

D I BNameLen 

03 1 B 

90 

F 2 

030F 

55 

bit 

morechars 

03 1 D 




56 

» 


03 1 D 

20 

8E 

FD 

57 

J 5r 

CROut ;Finish it off 

0320 




58 

* 

with a return 

0320 




59 

* 


0320 

60 



60 

r t s 


0321 




61 

* 


0321 




62 

* 


0321 



0321 

63 

Error equ 

« 

0321 




64 

* 


0321 




65 

* There's either 

no PC around, or there 

0321 




66 

* was no Unit * 1 

. . . give message 

0321 




67 



0321 

A2 

00 


68 

ldx 

#0 

0323 



0323 

69 

er r 1 equ 

* 

0323 

BD 

2F 

03 

70 

Ida 

Message , x 

0326 

F 0 

06 

032E 

71 

beq 

errout 

0328 

20 

ED 

FD 

72 

J 5r 

COut 

032B 

E8 



73 

i nx 


032C 

D0 

F5 

0323 

74 

bne 

er r 1 

032E 




75 

* 


032E 



032E 

76 

errout equ 


032E 

60 



77 

r t s 


032F 




78 

* 


032F 

CE 

CF 

A0 D0 

79 

Message asc 

'NO PC OR NO DEVICE' 

0341 

8D 

00 


80 

dfb 

$8D , 0 

0343 




81 

«- 


0343 




82 



0343 



0343 

83 

FindPC equ 


0343 




84 



0343 




85 

* Search slot 7 

to slot 1 looking for 

0343 




86 

* signature byt 

es 

0343 




87 

* 


0343 

A2 

07 


88 

ldx 

#7 ; Do for seven 

0345 




89 

* 

slots 

0345 

A9 

C7 


90 

Ida 

#$C7 

0347 

85 

07 


91 

s t a 

ZPTempH 
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0349: A9 

00 


92 



1 da 

#$00 

034B : 85 

06 


93 



5 t a 

ZPT empL 

034D : 



94 

* 




034D : 


034D 

95 

news lot 

equ 

* 

034D : A0 

07 


96 



ldy 

#7 

034F : 



97 

* 




034F : 


034F 

98 

aga i n 

equ 

# 

034F : B 1 

06 


99 



1 da 

CZPT empL) , y 

0351 :D9 

70 

03 

100 



cmp 

sigtab,y ;One of four 

0354: 



101 

* 



byte signature 

0354 : F0 

07 

035D 

102 



beq 

maybe ;Found one 

0356: 



103 

* 



signature byte 

0356 : C6 

07 


104 



dec 

ZPT empH 

0358 : CA 



105 



dex 


0359 : D0 

F 2 

034D 

106 



bne 

news lot 

035B : 



107 

* 




035B : 



108 

* 

I f we 

get here 

!, it's because we couldn' 

035B : 



109 

• 

find 

a Protocol Converter. 

035B : 



110 

* 

Exit with the 

carry set. 

035B : 



1 1 1 

* 




035B : 38 



112 



sec 


035C : 60 



113 



r t s 


035D : 



114 

* 




035D : 



115 

# 

I f we 

get here 

it means that one or 

035D : 



1 16 

* 

more 

of the s 

ignature bytes 

035D: 



117 

* 

for this card 

1 are what we're looking 

035D : 



1 18 

* 

f or . 

Decrement the byte 

035D : 



1 19 

* 

counter and branch back to verify any 

035D: 



120 

* 

remaining byt 

es . 

035D : 



121 

* 




035D: 


035D 

122 

maybe 

equ 

* 

035D : 88 



123 



dey 


035E : 88 



124 



dey 

; If N = 1 then 

035F : 



125 

* 



all s ig bytes okay 

035F : 10 

EE 

0 34F 

126 



bp 1 

aga i n 

0361 : 



127 

* 




0361 : 



128 

* 

Found 

a Protocol Converter interface. 

0361 : 



129 

* 

Set up the call address. 

0361 : 



130 

# 

We already have the high byte ($CN); 

0361 : 



131 

# 

we just need 

the low byte. 

0361 : 



132 

* 




0361 : 


0361 

133 

f oundPC 

equ 

* 

0361 : A9 

FF 


134 



1 da 

# $ FF 

0363:85 

06 


135 



5 1 a 

ZPTempL 

0365: A0 

00 


136 



1 dy 

#0 ; For 

0367: 



137 

* 



indirect load 

0367 : B 1 

06 


138 



Ida 

(ZPTempL), y ;Get the 

0369: 



139 

* 



byte 

0369: 



140 

* 




0369: 



141 

* 

Now the Acc has the low order ProDOS 

0369: 



142 

# 

entry 

point. 

The PC entry is 

0369: 



143 

« 

three 

locations past this... 
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0369 




144 

* 



0369 

18 



145 


c 1 c 


036A 

69 

03 


146 


adc 

*3 

036C 

85 

06 


147 


s t a 

ZPTempL 

036E 




148 

* 



036E 




149 

* How ZPTempL 

has the PC entry point. 

036E 




150 

* Return 

with 

carry clear. 

036E 




151 

* 



036E 

18 



152 


c 1 c 


036F 

60 



153 


r t s 


0370 




154 

* 



0370 




155 

* 



0370 




156 

# These are th 

e PC signature bytes in 

0370 




157 

* their relat 

i ve or der . 

0370 




158 

* The $FF 

byt 

es are filler bytes and 

0370 




159 

* are not 

compared . 

0370 




160 

* 



0370 

FF 

20 

FF 00 

161 

s i g t ab 

dfb 

$FF,$20,$FF,$00 

0374 

FF 

03 

FF 00 

162 


dfb 

$FF,$03,$FF,$00 

0378 




163 

* 



0378 




164 

* 



0378 



0378 

165 

Dispatch 

equ 

* 

0378 

6C 

06 

00 

166 


j m P 

(ZPTempL) ;Simulate 

037B 




167 

* 


an indirect JSR to PC 

037B 




168 

* 



037B 




169 

* 



037B 



0 37B 

170 

DParms 

equ 

# 

037B 

03 



171 

DPParmC t 

dfb 

3 ; Status 

037C 




172 

* 


calls have three parameters 

037C 

01 



173 

DPUni t 

dfb 

1 

037D 

80 

03 


174 

DPBuf fer 

dw 

DIB 

037F 

03 



175 

DPS t a t Code 

dfb 

3 

0380 




176 

* 



0380 




177 

* 



0380 



0380 

178 

DIB 

equ 

# 

0380 

00 



179 

DIBStatByte 1 dfb 0 

0381 

00 

00 

00 

180 

D I BDevS i z e 

dfb 

0,0,0 

0384 

00 



181 

D I BNameLen 

dfb 

0 

0385 



0010 

182 

D I BName 

ds 

16,0 

0395 

00 



183 

D I BType 

dfb 

0 

0396 

00 



184 

D I BSubType 

dfb 

0 

0397 

00 

00 


185 

D I BVer s ion 

dw 

0 

0399 




186 

* 



0399 




187 

* 
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6.6 Summary of Commands and Parameters 


Following is a summary of Protocol Converter calls. In each case, byte 0 of 
the command parameter list (CmdLst) specifies the number of parameters 
in the command list (not including byte 0). Parameters that require more 
than one byte (the status list pointer, for example) are entered low byte 
first. The meaning of the address-pointer parameter is device specific. See 
the sections on the individual calls in this chapter for a discussion of each 
parameter. 

Figure 6-1. Summary of Protocol Converter Calls 


Command 

STATUS 

READBLOCK 

WRITEBLOCK 

FORMAT 

CONTROL 

CmdNum 

$00 

$01 

$02 

$03 

$04 

CmdList Byte 

0 

$03 

CO 

CD 

$03 

$01 

$03 

1 

Unit Num 

Unit Num 

Unit Num 

Unit Num 

Unit Num 

2 

Stat List Ptr 

Buffer Ptr 

Buffer Ptr 


Ctl List Ptr 

3 


4 

Stat Code . 

Block Num 

Block Num 


Ctl Code 

5 




6 





Command 

INIT 

OPEN 

CLOSE 

READ 

WRITE 

CmdNum 

$05 

$06 

$07 

$08 

$09 

CmdList Byte 

0 

$01 

$01 

$01 

$04 

$04 

1 

$00 

Unit Num 

Unit Num 

Unit Num 

Unit Num 

2 




Buffer Ptr 

Buffer Ptr 

3 




4 




Byte Count 

Byte Count 

5 




6 




7 




Address Ptr 

Address Ptr 

8 





Unused bytes [ 


140 


Chapter 6: Disk Input and Output 


6.7 Summary of Error Codes 


Following is a summary of Protocol Converter call error codes, including a 
brief description of the possible causes for each. If there is no error, the C 
flag (in the processor status register of the 65C02 microprocessor) is cleared 
(0), and the accumulator (the A register) contains Os. If the call was 
unsuccessful, the C flag is set (1), and the A register contains the error code. 


$00 


No error. 

$01 

BadCmd 

A nonexistent command was issued. Check 
the command number in the Protocol 
Converter call. 

$04 

BadPCnt 

Bad call parameter count. The call 
parameter list was not properly 
constructed. Make sure the parameter list 
has the correct number of parameters. 

$06 

BusErr 

A communications error between the 
device controller and the host. Make sure 
that RAM is both read-enabled and 
write-enabled. Check the hardware (cables 
and connectors) between the device and 
the host. Check for noise sources; make 
sure the cable is properly shielded. 

$11 

BadUnit 

Unit number $00 was used in a call other 
than STATUS, CONTROL, or INIT. 

$21 

BadCtl 

The control or status code is not supported 
by the device. 

$22 

BadCtlParm 

The control parameter list contains invalid 
information. Make sure each value is within 
the range allowed for that parameter. 

$27 

IOError 

The device encountered an I/O error when 
trying to read or write to the recording 
medium. Make sure that the medium in the 
device is formatted and not defective. Make 
sure the device is operating correctly. 

$28 

NoDrive 

The device is not connected. This can occur 


if the device is not connected but its 
controller is, or if there is no device with the 
unit number specified. 
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$2B 

NoWrite 

The medium in the device is write 
protected. 

$2D 

BadBlock 

The block number is outside the range 
allowed for the medium in the device. Note 
that this range depends on the type of 
device and the type of medium in the 
device (single-sided vs. double-sided disk, 
for example). 

$2F 

Offline 

Device off-line or no disk in drive. Check 
the cables and connections; make sure the 
medium is present in the drive, and that the 
drive is functioning correctly. 

$30-$3F 

DevSpec 

Errors that differ from device to device. See 
the technical manual for the device in 
question for details. 

$40-$4F 


Reserved for future expansion. 

$50-$7F 

NonFatal 

A device-specific soft error. The operation 
completed successfully, but some exception 
condition was detected. See the technical 
manual for the device in question for 
details. 
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Chapter 7 


Serial I/O Port 1 
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AWarning 


Serial port 1 is one of two serial I/O ports available on the Apple lie. It is 
intended primarily as an output port for RS-232 devices, such as printers 
and plotters. It can be changed to a serial communication port (like port 2) 
either by using the System Utilities disk or from a program. 

Although the Apple lie serial ports are similar to the Apple lie Super 
Serial Card, there are important differences. Refer to Appendix F for a 
summary of these differences. 

Table 7-1 summarizes the characteristics of this port if used as a 
printer/plotter port, and is a guide to the other information in this chapter. 
If you change port 1 to a communication port, refer to the descriptions in 
Chapter 8, and use 1 instead of 2 for the port number when required. 

The serial port back panel connectors are described in Section 11.11. 


Table 7-1. Serial Port 1 Characteristics 

Port number: 

Commands: 


Initial characteristics: 
Hardware page locations: 
Monitor firmware routines: 
I/O firmware entry points: 
Use of screen holes: 

Use of other pages: 


Serial port 1 

Keyboard command: PR#1 

BASIC command: PR#1 

Monitor command: 1 CONTROL-P 
(does not work if there is an operating 
system in RAM) 

All other commands: See Table 7-2 
See Section 7.2 
See Table 7-3 
None 

See Table 7-4 
See Table 7-5 
None 
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Refer to Table 7-4 for the standard 
firmware entry points that Pascal 1.1 and 
1.2 use. 


UniDisk 3.5 


7.1 Using Serial Port 1 


You can access the firmware from BASIC in the usual way— that is, by 
issuing CONTROL-D (if DOS or ProDOS is in RAM) and PR#1. Subsequent 
output is directed to the printer (or other device) connected to serial port 1. 

To direct Pascal output to the printer, you can use either #6: or PRINTER: . 

Your programs can also access the port by changing the value of CSW (see 
Chapter 3). 

Table 7-2 lists the commands you can use with serial port 1, either from a 
program or from the keyboard, after you issue PR#1. 

Commands followed by an asterisk in Table 7-2 (with the exception of L) 
are available only on the version of the Apple lie that supports UniDisk 
3.5. These commands can be toggled by following them directly with E 
(enable) or D (disable). 

Each command must be preceded by CONTROL-I (the command character). 
As soon as you issue the command character, the serial port firmware 
displays a flashing question mark cursor to indicate it is awaiting a 
command. You do not have to press I return | after commands that you 
have entered from the keyboard, or send RETURN from your program if it is 
sending commands to the port. You can type more than one command on a 
line, but each must be preceded by the command character. 


Table 7-2. Printer Port Commands 

Note: The commands themselves are letter commands, not control characters. 


Command 

Description 

nnn 

Sets new line width of nnn (from 1 through 255). This 
command must be followed by N (see below) or by a carriage 


return. 

nnB 

Sets baud rate to value corresponding to nn: 


nn 

Rate 

nn 

Rate 

1 

50 

9 

1800 

2 

75 

10 

2400 

3 

110(109.92) 

11 

3600 

4 

135 (134.58) 

12 

4800 

5 

150 

13 

7200 

6 

300 

14 

9600 

7 

600 

15 

19200 

8 

1200 
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Table 7-2— continued. Printer Port Commands 

Note: The commands themselves are letter commands, not control characters. 


Command 

C* 


nD 


p* 


I 

K 

L* 


M* 


nnnN 


Description 

When enabled, this command causes a carriage return 
character to be sent automatically whenever the column 
count exceeds the printer line width. The command is 
normally enabled. 

Sets data format to values corresponding to n: 


Data Stop 

n Bits Bits 

0 8 1 

1 7 1 

2 6 1 

3 5 1 

4 8 2 

5 7 2 

6 6 2 

7 5 2 


When this command is enabled, your Apple lie accepts data 
from the keyboard as well as from the serial port. You can use 
this to disable the keyboard before receiving or sending data 
to prevent accidental keystrokes from disrupting the data 
flow. Be sure that your program reenables the keyboard when 
the data transfer is complete. This command is available only 
from BASIC and is normally enabled. 

Echoes printer output on the screen. 

Disables automatic line feed after carriage return. 

Generates line feed after carriage return. Normally, this 
command is enabled. Disabling it has the same effect as the K 
command. 

When this command in enabled, all incoming line feed 
characters are masked (removed from the data stream). 
Normally this command is enabled. 

Changes line width to nnn (from 1 through 255; nnn is 
optional); does not echo printer output on the screen. 

Note: ON does not disable automatic generation of carriage 
return; to do so, use Z command, put 0 directly in 
location $0579, or use System Utilities disk. 
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Table 7-2 — continued. Printer Port Commands 

Note: The commands themselves are letter commands, not control characters. 


Command Description 

nP Sets parity corresponding to n: 

n Parity 

0 none 

1 odd 

2 none 

3 even 

4 none 

5 MARK (1) 

6 none 

7 SPACE (0) 

R Resets port 1 (Section 7.2) and exits from serial port 1 

firmware. 

S Sends a 233-millisecond BREAK character (used with some 

printers to synchronize with serial ports). 

X* When enabled, this command turns on the XON/XOFF 

protocol: the Apple lie looks for the XOFF ($13) character and 
responds by halting transmission until an XON ($11) is 
received. Normally this command is disabled. 

Z Zaps (ignores) further command characters until 

I control | - l reset | or PR#1. Does not format output or insert 
carriage returns into output stream. 

* Command (with the exception of L) is available only on the version of the Apple lie that 
supports UniDisk 3.5. Command can be toggled: If you follow the command with E (with 
no intervening space), the command is enabled. If you follow the command with D (with 
no intervening space), command is disabled. The L command is available on the earlier 
Apple lie, but cannot be toggled there. 


The serial port 1 command character is set as CONTROL-I when the 
Apple lie is turned on. You can change it to a different control character by 
sending the current control character followed immediately by the new 
control character you want. This is useful if you want to be able to send 
CONTROL-I to the printer without firmware intervention. For example, to 
change the command character from CONTROL-I to CONTROL-V, send 
CONTROL-I CONTROL-V either from the keyboard or a program. 
(CONTROL-V and CONTROL-W are the recommended substitute control 
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characters.) To change the command character back again, send 
CONTROL-V CONTROL-I. Don’t slip any spaces between the control 
characters that you send. 


▲Warning 


Do not use CONTROL-A, -B, -C, -H, -J, -L, -M, or -Y: Apple lie firmware 
may intercept these control characters, causing unpredictable results. 


The following are examples of valid commands and command sequences. 
These examples all show commands being entered from the keyboard, but 
your programs can send the characters just as well. Remember to issue a 
PR#1 before starting to send commands to serial port 1. 


To echo output to the display screen: 

i control i -m rn 

To set line width 72, disable line feed, and echo: 

I CONTROL H TI m [CONTROL N T1 f7~l (~2~1 |~N~| 

To change control character to CONTROL-V: 


I CONTROL l -m I CONTROlTTvI I RETURN I 

To set up the serial port to allow sending CONTROL-I as part of a character 
stream: 

I control H~v~] (command) | return | 


7.2 Characteristics of Port 1 at Startup 

After power-up, the printer firmware sets the following configuration: 

□ 9600 baud 

□ eight data bits, no parity bits, two stop bits 

□ 80-column line width; no echo to display screen 

□ firmware supplies line feed after carriage return 

□ command character is set to CONTROL-I 

These values are stored in the auxiliary memory screen holes (Table 7-5). 
You can change some of these settings from the keyboard by typing pr# i , 
the command character, and one of the commands listed in Table 7-2. 
Section 7.6 describes how port characteristics change as a result of various 
activities. 
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7.3 Hardware Page Locations for Port 1 


▲Warning 


Table 7-3 lists for serial port 1 the addresses and bit assignments of its 
hardware registers on page $C0. The registers are internal to a 6551 ACIA; 
their bit assignments are described in Section 11.11. 

This table is for your information only. To avoid having problems with 
the system, you should never try to directly access the hardware. 
Instead, use the Apple He’s built-in firmware in your programs. 


Table 7-3. Port 1 Hardware Page Locations 



Location 

Description 


$C090-$C097 

Reserved 

ACIA stands for asynchronous 

$C098 

ACIA transmit/receive data register 

communication interface adapter, a serial 

$C099 

ACIA status register 

I/O chip. Note in Chapter 11 that some of 

SC09A 

ACIA command register 

the bit assignments for this port differ from 

$C09B 

ACIA control register 

those for port 2. 

$C09C-$C09F 

Reserved 


7.4 I/O Firmware Support for Port 1 


Table 7-4 lists the locations and values of the I/O firmware protocol table. 
This standardized protocol is available for use by any application program. 
Section 3.4.2 describes how to use this protocol. 


Table 7-4. Port 1 I/O Firmware Protocol 


Address 

Value 

Description 

$C105 

$38 

Pascal ID byte 

$C107 

$18 

Pascal ID byte 

SC10B 

$01 

Generic signature byte of firmware cards 

$C10C 

$31 

Same ID as for Super Serial Card 

$C10D 

$ii 

SClii is entry point of initialization routine (PInit). 

$C10E 

$rr 

$Clrr is entry point of read routine (PRead). 

$C10F 

$ww 

$Clww is entry point of write routine (PWrite). 

$C110 

$ss 

SClss is entry point of the status routine (PStatus). 

SClll 

nonzero 

No optional routines 


7.4 1/0 Firmware Support for Port 1 
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7.5 Screen Hole Locations for Port 1 


The ACIA register bits are defined in 
Chapter 11. 


Table 7-5 lists the screen hole locations that serial port 1 uses. Note that the 
auxiliary memory locations are reserved for startup value settings, which 
are listed and interpreted in the table. 


Table 7-5. Port 1 Screen Hole Locations 


Auxiliary Memory Screen Holes (firmware loads values at power-up): 


Location 

Description 

$0478 

$9E (ACIA control reg: eight data + two stop bits, 
9600 baud) 

$0479 

$0B (ACIA command reg: no parity) 

$047A 

$40 (flags: no echo, auto LF after CR, serial port) 


Bit Interpretation 

7 Echo output on display (0 = no echo) 

6 Generate LF after CR (0 = no LF) 

5-1 Always = 0 (reserved) 

0 1 = communication port; 0 = serial printer 

port 

S047B $50 (printer width: 80 columns) 

Bit Interpretation 

7-0 Printer width (0 = do not insert CR) 


Main Memory Screen Holes: 

Location Description 

$0479 Reserved 

$04F9 Reserved 

$0579 Printer width (1-255; 0 = disable formatting) 

$05F9 Temporary storage location 

$0679 Bit 7 = 1 while the firmware is parsing a command string 

$06F9 Current command character (initially CONTROL-I) 

$0779 Bit 7 = 1 if echo to display is on; bit 6 = 1 if firmware is to 

generate a line feed after carriage return 

$07F9 Current printer column 
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7.6 Changing Port 1 Characteristics 

Figure 7-1 is a diagram of where the port characteristics are stored and 
moved under different circumstances. You can see the following from the 
figure: 

□ When the power is first turned on, the Monitor reset firmware moves the 
predefined set of port characteristics listed in Section 7.2 from ROM into 
the auxiliary memory screen holes listed in Table 7-5. 

□ If you specify new characteristics using the System Utilities disk, the 
SUD software changes the values in the auxiliary memory screen holes. 
Your programs can do the same thing. 

□ The values stored in the auxiliary memory screen holes are affected by 
power-on reset, but not by either fol- l control! - ! reset i or a simple 

I control H reset | . This feature is provided so that a port that has been 
reconfigured will remain that way while some other program (such as an 
application program) is started up. 


Figure 7-1. Diagram of Port 1 Characteristics Storage 
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□ PR#1 causes the firmware to move the characteristics stored in the 
auxiliary memory screen holes into the main memory screen holes. 

□ A program can change values in the main memory screen holes directly. 
However, the only value guaranteed to be in the same place for the entire 
Apple II series is the line length in main memory location $0579. 

n The firmware uses the port as it is defined in the main memory screen 
holes at any given time. You should use the commands listed in Table 7-2 
to change them. 


7.6.1 Data Format and Baud Rate 

Serial data transfer consists of a string of Is and Os sent down a wire at a 
prearranged rate of transmission, called the baud rate. 

Before transfer begins, both sender and receiver look for a continuous value 
of 1: this is called the carrier (Figure 7-2). When the value goes to 0, the 
receiver presumes it is a start bit— that is, the bit that designates the 
beginning of a character of data. If it lasts longer than a bit could possibly 
last, it is considered a BREAK signal, which some printers use for 
synchronization. 

If the first 0 proves to be a bit, it is interpreted as the start bit. Next come 
the seven or eight data bits (six is seldom used with computers), low-order 
bit first. If parity is on, it comes next in the message. Finally, one or two 
stop bits appear. The stop bits have a value of 1, like the carrier. The next 
start bit begins transfer of the next character of data. 

The parity bit provides a simple check of data validity. Odd parity means 
the sender counts the number of Is among the data bits, and sends the 
appropriate parity bit to make the total number of Is odd. With even parity, 
the sender adds the appropriate parity bit to make the total number of 1 bits 
even. MARK parity is always a 1 bit; SPACE parity is always a 0. The 
receiver can then check that the parity bit is correct. 

If the baud rate is 300, and the data format is one start bit plus seven data 
bits plus one parity bit plus one stop bit (totaling ten bits transmitted for 
each byte of data sent), then the actual transfer rate is about 30 characters 
per second. 
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Figure 7-2. Data Format 
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ASCII letter M = $4D; sent as 8 data, odd parity, 1 stop bit. 


7.6.2 Carriage Return and Line Feed 

If you are using a typewriter and you push the carriage all the way to the 
right (in other words, position the printing mechanism at the left margin), 
you have performed a carriage return. On the other hand, turning the platen 
so the paper moves to the next line (or using the index key on an electric 
typewriter) is called a line feed. Most typewriters perform a line feed 
automatically after a carriage return, and so the two seem to be one— but 
they are not. 

Carriage return and line feed are separate ASCII codes. Carriage return is 
sometimes denoted CR; it is ASCII code 13 ($0D). Line feed, sometimes 
denoted LF, is ASCII code 10 ($0A). (T| on the Apple lie keyboard generates 
aLF. 

Some printers can supply a line feed automatically after detecting a 
carriage return; others cannot. If the printer does not supply a line feed after 
a carriage return and it is not supplied in the data stream, the printer keeps 
printing over and over on the same line. On the other hand, if both the 
printer and the Apple lie firmware supply LF after CR, double line-spacing 
results. 

If the print head keeps moving too far to the right across the page and then 
prints many characters on top of one another on the right, then the 
firmware should be instructed to furnish CR after a certain line width has 
been reached. If the printer prints too short a line before moving to the next 
line, then probably the firmware is using too small a line width. 
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If the printer misses characters at the beginning of each line but otherwise 
prints correctly, there is probably not enough time for the print mechanism 
to return to the left margin in response to CR. You must use a lower baud 
rate with such a printer. 


7.6.3 Sending Special Characters 

If you want to send special characters (control characters) to the printer 
without having them intercepted and executed by the Apple lie firmware, 
use the Z command (see Table 7-2). If the only special character that causes 
a problem is the command character (normally CONTROL-I for port 1), you 
can change just the command character instead of using the zap (Z) 
command. If you use the zap command, the firmware does no formatting; 
that is, it does not check line width or insert carriage returns or line feeds. 
This may be necessary to send graphics to a printer or plotter. 


7.6.4 Displaying Output on the Screen 

You can display printer output on the screen, but if the printer line width 
exceeds the 40 or 80 columns you have selected for display, you should turn 
off video display. 
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Chapter 8 


Serial I/O Port 2 
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Serial port 2 is one of two serial I/O ports available on the Apple lie. It is 
intended primarily as a communication port for modems. You can change it 
to a serial printer port (like port 1) using the System Utilities disk or from a 
program. 


AWarning 


Although the Apple lie serial ports are similar to the Apple He Super Serial 
Card, there are important differences. Refer to Appendix F for a summary 
of these differences. 


Table 8-1 summarizes the characteristics of this port and is a guide to the 
other information in this chapter. If you change port 2 to a serial printer 
port, refer to the descriptions in Chapter 7, and use 2 instead of 1 for the 
port number when required. 

The serial port connectors are described in Section 11.11. 


Table 8-1. Serial Port 2 Characteristics 


Port number: 
Commands: 


Initial characteristics: 


Serial port 2 

Keyboard commands: 

IN#2 before Table 8-2 commands 
IN #2 to accept port 2 input 
PR#1 to echo input to printer 
PR#2 to echo input back to port 2 

BASIC commands: same 

Monitor command: 2 CONTROL-P 
(does not work if there is an operating 
system in RAM) 

All other commands: See Table 8-2 
See Section 8.2 


Hardware page locations: See Table 8-3 

Monitor firmware routines: None 


I/O firmware entry points: See Table 8-4 

Use of screen holes: See Table 8-5 


Use of other pages: In terminal mode, firmware uses 

auxiliary memory locations 
$0800-$087F to store keyboard input, 
and $0880-$08FF as a serial input 
buffer. 
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Important! 


Refer to Table 8-4 for the standard 
firmware entry points that Pascal 1.1 and 
1.2 use. 


UniDisk 3.5 


8.1 Using Serial Port 2 


You can access the firmware from BASIC in the usual way — that is, by 
issuing CONTROL-D (if DOS or ProDOS is in RAM) followed by IN#2 or 
PR#2. Subsequent input and output are routed through the modem (or other 
device) connected to serial port 2. 

In terminal mode, the modem port commands listed in Table 8-2 must 
follow CONTROL-D and IN#2 (not PR#2) and the command character 
(which is usually CONTROL-A). 

To transfer files to the modem under Pascal, specify REMOUT: or #8: . To 
transfer files from the modem under Pascal, specify REMIN: or #7: . 

Table 8-2 lists the commands you can use with serial port 2, either from a 
program or from the keyboard, after you issue IN#2. 

Commands followed by an asterisk in Table 8-2 (with the exception of L) 
are available only on the version of the Apple lie that supports UniDisk 
3.5. These commands can be toggled by following them directly with E 
(enable) or D (disable). 

Each command must be preceded by CONTROL-A (the command 
character). As soon as you issue the command character, the serial port 
firmware displays a flashing question mark cursor to indicate it is awaiting 
a command. If you press I return | , you get the current video cursor again. 
You do not have to press | return | (or send a RETURN character) after 
commands. You can type more than one command on a line, but each must 
be preceded by the command character. 


Table 8-2. Modem Port Commands 

Note: The commands themselves are letter commands, not control characters. 


Command Description 

nnn Sets new line width of nnn (from 1 through 255); this must be 

followed immediately by N (see below) or by carriage return. 

nnB Sets baud rate to value corresponding to nn: 


nn 

Rate 

nn 

Rate 

nn 

Rate 

1 

50 

6 

300 

11 

3600 

2 

75 

7 

600 

12 

4800 

3 

110(109.92) 

8 

1200 

13 

7200 

4 

135 (134.58) 

9 

1800 

14 

9600 

5 

150 

10 

2400 

15 

19200 
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Table 8-2 — continued. Modem Port Commands 

Note: The commands themselves are letter commands, not control characters. 


Command 

c* 


nD 


F* 


I 

K 

L* 


M* 


nnnN 


Description 

When enabled, this command causes a carriage return 
character to be sent automatically whenever the column 
count exceeds the printer line width. The command is 
normally enabled. 

Sets data format to values corresponding to n: 


Data Stop 

n Bits Bits 

0 8 1 

1 7 1 

2 6 1 

3 5 1 

4 8 2 

5 7 2 

6 6 2 

7 5 2 


When this command is enabled, your Apple lie accepts data 
from the keyboard as well as from the serial port. You can use 
this to disable the keyboard before receiving or sending data 
to prevent accidental keystrokes from disrupting the data 
flow. Be sure that your program reenables the keyboard when 
the data transfer is complete. This command is available only 
from BASIC and is normally enabled. 

Echoes output on the screen. 

Disables automatic line feed after carriage return. 

Generates line feed after carriage return. Normally, this 
command is enabled. Disabling it has the same effect as the K 
command. 

When this command in enabled, all incoming line feed 
characters are masked (removed from the data stream). 
Normally this command is enabled. 

Sets line width to nnn (from 1 through 255); does not echo 
output on the screen. Note: ON does not disable automatic 
generation of carriage return; to do so, use Z command, put 0 
directly in location S057A, or use System Utilities disk. 
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Table 8-2— continued. Modem Port Commands 

Note: The commands themselves are letter commands, not control characters. 


Command 

Description 

nP 

Sets parity corresponding to n: 

n Parity 

0 none 

1 odd 

2 none 

3 even 

4 none 

5 MARK (1) 

6 none 

7 SPACE (0) 

Q 

Quits terminal mode. 

R 

Resets port 2 (Section 8.2) and exits from serial port 2 
firmware. 

S 

Sends a 233-millisecond BREAK character. 

T 

Enters terminal mode. Use this command after IN#2 only. 

Also, if you follow this command by PR#2, the Apple lie 
echoes input to output. (If the other device does so too, the 
first character loops endlessly, locking up the system. Use 

I CONTROL l-l RESET | to get OUt.) 

X* 

When enabled, this command turns on the XON/XOFF 
protocol: the Apple lie looks for the XOFF ($13) character and 
responds by halting transmission until an XON ($11) is 
received. Normally this command is disabled. 

Z 

Zaps (ignores) further command characters until 

1 control |-| reset |. Does not format output or insert carriage 
returns into output stream. 

| CONTROL |-m 

This command from a remote device puts the Apple lie in 
terminal mode if IN#2 is already in effect. It is the same as 

1 control i-fAim typed locally. 

| CONTROL |-| R | 

This command from a remote device undoes the terminal 
mode command. If IN#2 and PR#2 are in effect, the remote 
keyboard and display become the input and output devices of 
the local Apple lie. It is the same as | control i-HaI fol typed 


locally. 

* Command (with the exception of L) available only on the version of the Apple lie that 
supports UniDisk 3.5. Command can be toggled: If you follow the command with E (with 
no intervening space) the command is enabled. If you follow the command with D (with 
no intervening space) the command is disabled. The L command is available on the 
earlier Apple lie, but it cannot be toggled there. 
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▲Warning 


When the Apple lie is turned on, the serial port 2 command character is 
defined as a CONTROL-A. You can change it to a different control character 
by typing the current control character followed immediately by the new 
control character you want. This is useful if you want to be able to send 
CONTROL-A to the output device without firmware intervention. 

For example, to change the command character from CONTROL-A to 
CONTROL- V, send CONTROL-A CONTROL-V either from the keyboard or a 
program. (CONTROL-V and CONTROL-W are the recommended substitute 
control characters.) To change the command character back again, send 
CONTROL-V CONTROL-A. 

Do not use CONTROL-B, -C, -H, -I, -J, -L, -M, or -Y: Apple lie firmware may 
intercept these control characters, causing unpredictable results. 

The following are examples of valid commands and command sequences. 
These examples all show commands being entered from the keyboard, but 
your programs can send the characters just as well. 

To enable echo to the screen: 

I control H~A~i m 

To send a BREAK character to a remote device: 

I control H~a1 [~b~1 

To change the control character to CONTROL-V (for example, so you can 
send CONTROL-A as part of a character stream): 

I control Ha] I control H~v~] | control H~v~l (command) 


8.2 Characteristics of Port 2 at Startup 

After power-up, the firmware sets the following configuration: 

□ 300 baud 

□ eight data bits, no parity bits, one stop bit 

□ firmware does not supply line feed after carriage return 

□ firmware does not insert carriage returns into output stream 

□ firmware does not echo output to the display screen 

□ command character is set to CONTROL-A 
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These values are stored in the auxiliary memory screen holes (Table 8-5). 
You can change some of these settings from the keyboard using the 
command character followed by one of the commands listed in Table 8-2. 
Section 8.6 describes how port characteristics change as a result of various 
activities. 

If you change any of these values using keyboard commands or commands 
from a program, subsequent accesses to the port firmware (even by another 
program) use the new settings instead of the power-up values. This allows 
you to change the settings once at system startup, and get the desired 
configuration for subsequent uses. Refer to Section 8.6 for a complete 
description of these processes. 


8.3 Hardware Page Locations for Port 2 


Table 8-3 lists for serial port 2 the addresses of its hardware registers on 
page $C0. The registers are internal to a 6551 ACIA; their bit assignments 
are described in Section 11.11. 

AWarning 

This table is for your information only. To avoid having problems with 
your system, you should never try to directly access the hardware. 
Instead, use the Apple lie’s built-in firmware in your programs. 


Table 8-3. Port 2 Hardware Page Locations 


Location 

Description 


$C0A0-$C0A7 

Reserved 

ACIA stands for asynchronous 

$C0A8 

ACIA transmit/receive data register 

communication interface adapter, a serial 

$C0A9 

ACIA status register 

I/O chip. Note in Chapter 11 that some of 

$C0AA 

ACIA command register 

the bit assignments for this port differ from 

$C0AB 

ACIA control register 

those for port 1. 

$C0AC-$C0AF 

Reserved 


8.4 I/O Firmware Support for Port 2 


Table 8-4 lists the values in the I/O firmware protocol table for serial port 2. 
This standardized protocol is available for use by any application program. 
Section 3.4.2 describes how to use this protocol. 
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Table 8-4. Port 2 I/O Firmware Protocol 


The ACIA register bits are defined in 
Chapter 11. 


Address 

Value 

$C205 

$38 

$C207 

$18 

$C20B 

$01 

$C20C 

$31 

$C20D 

$ii 

$C20E 

$rr 

$C20F 

$ww 

$C210 

$ss 

SC211 

nonzero 


Description 

Pascal ID byte 
Pascal ID byte 

Generic signature byte of firmware cards 
Same ID as for Super Serial Card 
$C2ii is entry point of initialization routine (PInit). 
$C2rr is entry point of read routine (PRead). 

$C2ww is entry point of write routine (PWrite). 
$C2ss is entry point of the status routine (PStatus). 
No optional routines 


8.5 Screen Hole Locations for Port 2 


Table 8-5 lists the screen hole locations that serial port 2 uses. Note that the 
auxiliary memory locations are reserved for startup value settings, which 
are listed and interpreted in the table. 


Table 8-5. Port 2 Screen Hole Locations 


Auxiliary Memory Screen Holes (firmware loads values at power-up) : 


Location 

Description 


$047C 

$16 (ACIA control reg: eight data + one stop bit, 300 baud) 

$047D 

SOB (ACIA command reg: no parity) 

$047E 

$01 (flags: no echo, no auto LF after CR, communication 


port) 



Bit 

Interpretation 


7 

Echo output on display (0 = no echo) 


6 

Generate LF after CR (0 = no LF) 


5-1 

Always = 0 (reserved) 


0 

1 = communication port; 0 = serial printer 
port 

$047F 

$00 (line length: do not add any CR to output stream) 


Bit 

Interpretation 


7-0 

Line length (0 = do not insert CR) 
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Table 8-5 — continued. Port 2 Screen Hole Locations 


Main Memory Screen Holes: 

Location Description 

$047A Reserved 

$04FA Reserved 

$057A Line length (1-255; 0 = disable formatting) 

$05FA Temporary storage location 

$067A Bit 7 = 1 if and only if the firmware is currently parsing a 

command string 

$06FA Current command character (initially CONTROL-I) 

$077A Bit 7 = 1 if echo to display is on; bit 6 = 1 if firmware is to 

generate a line feed after carriage return 

$07FA Current column 


8.6 Changing Port 2 Characteristics 

Figure 8-1 is a diagram of where the port characteristics are stored and 

moved under different circumstances. You can see the following from the 

figure: 

□ When the power is first turned on, the Monitor reset firmware moves the 
predefined set of port characteristics listed in Table 8-2 from ROM into 
the auxiliary memory screen holes listed in Table 8-5. 

□ If you specify new characteristics using the System Utilities disk, the 
utility software changes the values in the auxiliary memory screen holes. 

□ The values stored in the auxiliary memory screen holes are affected by 
power-on reset, but not by either [cTH control H reset l or a simple 

I control H reset | . This feature is provided so that a port that has been 
reconfigured will remain that way while some other program (such as an 
application program) is started up. 

□ IN#2 causes the firmware to move the characteristics stored in the 
auxiliary memory screen holes into the main memory screen holes. 

□ A program can change values in the main memory screen holes directly. 
However, the only value guaranteed to be in the same place for the entire 
Apple II series is the line length in main memory location $057A. 
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Figure 8-L Diagram of Port 2 Characteristics Storage 



□ The firmware uses the port as it is defined in the main memory screen 
holes at any given time. You should use the commands listed in Table 8-2 
to change these characteristics. 


8.6.1 Data Format and Baud Rate 

Section 7.6.1 describes data format and baud rate, and explains how they 
apply to printers. Refer to that section for definitions of terms. 

A noteworthy characteristic of data communication is its strangeness: 
sometimes the oddest changes make a given communication arrangement 
work or not work. You must keep this notion firmly in mind when working 
with serial port 2. 
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For example, modem communication involves quite a few elements 
(Figure 8-2): 

□ the Apple lie and its firmware, with the baud rate, data format, and other 
characteristics you have selected 

□ the cable from the Apple lie to the modem 

□ the modem 

□ possibly an acoustic coupler for a telephone handset 

□ the telephone lines, with their switching equipment, boosters, and noise 

□ some combination of modem, cable, and remote computer or terminal 

As you can imagine, some method is required for successful data 
transmission. If you have problems, change only one variable at a time, and 
then cycle through the other variables one at a time. Take nothing for 
granted. The data format advertised for an information service, for 
example, may be different from the one you end up using with the 
Apple lie. 



(Data Terminal (Data Communication 

Equipment) Equipment) 
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8.6.2 Carriage Return and Line Feed 


If you are communicating with a computer or terminal, carriage return and 
line feed may or may not be involved. Start off without generating them, 
and turn on automatic generation only as needed. They are described as 
used with printers in Section 7.6.2. 


8.6.3 Routing Input and Output 

This section discusses the possible ways that serial port 2 can route 
information. Sometimes the cause of communication problems is that 
information is not going where you think it is, or it is and you cannot see 
evidence of the fact. Figures 8-3 through 8-6 show some of the patterns of 
information flow you can select. This section and the following subsections 
tell you how to use them. 

It is best to read all this material as a unit: questions that arise while you 
read one description may be answered elsewhere. 

The simplest serial port 2 command is IN#2 (Figure 8-3). Port 2 becomes the 
input device. Data coming into the port gets passed to the input buffer 
(page $02 of main memory). Applesoft firmware and system software can 
see the data and carry out commands in the normal way. 

Of course, you can also use just the PR#2 command— for example, if you 
want to send a listing to the modem. 


For a further description of what terminal 
mode does and how to get into and out of it, 
refer to the last section of this chapter. 


To usejjort 2 for data communication, you ordinarily put it into terminal 
mode. Following IN#2, pressing | control K~a~| gets the attention of the 
port 2 firmware, which displays a blinking question mark (?) as a prompt. 
Now type T to put the computer in terminal mode. In this mode, the 
firmware displays a blinking underscore character ( _ ) as a prompt. 

In the discussion that follows, local refers to your Apple lie. Remote refers 
to some other device, usually in a distant location and at the other end of a 
communication link. The remote device can be any ASCII-generating unit: a 
terminal or a computer. 


If a remote computer is another Apple lie or an Apple II series machine with 
a Super Serial Card in it, then most of the commands described here apply 
to it as well. 
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Figure 8-3. Effect of IN#2 


oF^ 



Half-Dup l ex Operation 

In half-duplex operation, information can flow from A to B or from B to A, 
but in only one direction at a time. In a half-duplex setup, the host does not 
echo back to the terminal what the terminal sends it. For half-duplex 
operation, use IN#2 and CONTROL-A T (Figure 8-4) whether the Apple lie 
is the host or the terminal. 

IN#2 plus CONTROL-A T is the best way to set up the computer for 
auto-answer operation. The T command allows port 2 firmware to exchange 
information with the local modem without interference from the local 
firmware or system software. (The remote device can always cancel the 
T command with CONTROL-R if necessary, and restore terminal mode with 
CONTROL-T.) Avoiding PR#2 at this point means that the Apple lie can 
operate as a half-duplex terminal, half-duplex host, or full-duplex terminal. 
(The remote device can also issue CONTROL-A PR#2 if PR#2 is required at 
the local computer.) 
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Figure 8-4. Effect of IN#2 and T Command (Half Duplex) 
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In half-duplex operation, the output hook is available for other uses. For 
example, you can issue PR#1 to print incoming messages from port 2. Use 
the CONTROL-A I command to display information on the screen. 

Full-Duplex Operation 

In full-duplex operation, information can flow from A to B and from B to A 
simultaneously. Typically, one of the computers (the host computer) echoes 
its input to output, so the other computer (the terminal) can easily verify 
that the communication is taking place. 

Figure 8-5 shows the flow of information when the Apple lie is a full-duplex 
terminal. (The setup commands, IN#2 and CONTROL-A T, are the same as 
for half duplex.) 
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Figure 8-5. Effect of IN#2 and T Command (Full-Duplex Terminal) 
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If your Apple lie is the terminal in full-duplex operation, use the 
N command to turn off echoing input to the screen. If the Apple lie does 
echo input to the screen in this setup, everything you type will appear 
twice: once from the Apple lie and once from the host computer. 

In this mode of operation, if you echo input to the printer you can get a 
printed record of both sides of the communication session: the input from 
the host, and the Apple lie output as echoed by the host. 

Figure 8-6 shows the flow of information when the Apple lie is a full-duplex 
host. In this case, the local Apple lie must echo input to output for the 
remote device. The setup commands include PR#2 in this case. 
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Figure 8-6. Effect of IN#2, PR#2, and T Command (Full-Duplex Host) 
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AWarning 


If the Apple lie echoes input to output and the other computer does too, 
then the first subsequent keypress will echo back and forth endlessly and 
lock up the Apple lie. This will require a | control H reset | to get out. 

If you echo input to output when using an information service, the host 
will end up seeing the echo of what it sent you as though you had typed 
it. 


In this arrangement, the local output hook is not available for using the 
printer or other device. To display keyboard and port 2 input on the screen, 
issue CONTROL-A I. 


170 


Chapter 8: Serial I/O Port 2 


Terminal Mode 


Terminal mode makes the Apple lie act like a dumb terminal— one that just 
sends and receives information, but does not process it. Input and output 
flow through special serial I/O buffers on page $08 of auxiliary memory. 
Applesoft firmware and system software cannot see or interpret the data: 
only the serial port 2 firmware deals with it. 

In most terminal mode setups, the firmware will not display port 2 input 
unless you use the CONTROL-A I command. 


▲Warning 


When using terminal mode, $0800-$08FF of auxiliary RAM is used for 
buffering. Any data stored there will be overwritten when terminal mode 
is enabled. 


CONTROL-A T turns on terminal mode, and CONTROL-A Q turns it off. 

The remote device can go into terminal mode, and then turn off the local 
Apple He’s terminal mode with the CONTROL-R command. If it then issues 
CONTROL-A PR#2, local output will go to the remote device. The remote 
keyboard and display then become the input and output devices of the local 
Apple lie processor. This is remote mode. 

In remote mode, the local Apple lie does not use the serial I/O buffers (as it 
does in terminal mode); therefore, local firmware and system software 
detect and interpret all input and output data. So, for example, if you type 
catalog at the remote device keyboard, the local Apple lie will execute 
the command and list the disk catalog on the remote device’s display. (In 
terminal mode, the local computer would simply display the word 
catalog on its screen.) 

The remote device can turn the local Apple He’s terminal mode back on 
with CONTROL-T. CONTROL-A T issued at the remote device only turns on 
the remote device’s terminal mode, unless the command character there 
has already been changed to something else. 
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This chapter describes the Apple He’s mouse port and hand controller 
(game) input capabilities. The mouse and hand controllers use the same 
9-pin connector on the back panel; the firmware uses the port as directed by 
keyboard or program commands. 

A program can tell if a hand controller is connected (Section 9.2) but not if a 
mouse is connected, unless the computer user moves it. 


9.1 Mouse Input 


Table 9-1 summarizes the mouse port’s characteristics and guides you to 
other information in this part of the chapter. 


▲Warning 


If you want your programs that use the mouse on the Apple He and other 
Apple II series computers to work with the Apple lie, always use the I/O 
firmware entry points listed in Tables 9-4 and 9-5, rather than dealing 
directly with the mouse hardware and RAM locations. 


The mouse back panel connector is described in Section 11.12. 


Table 9-1. Mouse Input Port Characteristics 


Port number: 
BASIC commands: 


Initial characteristics: 

Hardware page locations: 
Monitor firmware routines: 
I/O firmware entry points: 
Use of screen holes: 


Mouse input port 4 

Turn on mouse: 

PRINT CHR$(4)“PR#4”:PRINT 
CHR$(1) 

Turn off mouse interrupts: 
PRINT“PR#4’’:PRINT CHR$(0) 

Turn on graphics character set: See 
Section 5.2.2. 

After a reset, all mouse interrupts are 
off, and the rising edge of XO and YO 
are selected for interrupts. 

See Table 9-2 

None 

See Table 9-3 and Table 9-4 
See Table 9-5 
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9.1.1 Mouse Connector Signals 


The mouse uses the same DB-9 connector as the hand controllers. However, 
the interpretation of the signals arriving on the pins differs depending on 
the commands and signals received. Figure 11-37 shows the names of the 
pin assignments when a mouse is connected. 


9.1.2 Mouse Operating Modes 

This section tells what the mouse operating modes are for. Later sections of 
this chapter describe how to set the various mouse operating modes. 

Your program should call the ServeMouse routine to determine the source of 
an interrupt as soon as it receives one, in all the interrupt modes except 
transparent mode. 

Transparent Mode 

In transparent mode, your program must read screen holes to check for 
mouse movement. An interrupt routine in the Apple lie firmware updates 
mouse position counters each time the mouse is moved, then returns control 
to the main program task. The findings of the interrupt routine are placed in 
the screen holes for your program to find. Table 9-5 lists the screen holes 
with the information that your program should look for. 

This is the only mouse mode available to BASIC programs. 

Movement Interrupt Mode 

On the Apple lie, a signal called VBlInt can interrupt the processor 
whenever a video vertical blanking signal occurs. This can make it easier 
for your programs to smoothly move the mouse cursor in response to mouse 
movements. 

In movement interrupt mode, the mouse firmware arms VBlInt whenever 
the mouse is moved at least one count in any direction. When VBlInt 
occurs, program control passes to the vector address contained at 
locations $03FE and $03FF; the interrupt handler in your program can then 
update the cursor smoothly to its next screen position. 
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Section 5.2.2 contains recommendations for 
using MouseText characters with a mouse. 


Appendix E explains how the firmware 
handles interrupts. 

▲Warning 


Your program’s interrupt handler must first call ServeMouse (Table 9-3) to 
see if the mouse caused the interrupt. It should then call ReadMouse to get 
mouse status and its current X-Y position. The routine can also change the 
mouse mode and position if desired. 

The maximum amount of mouse movement that can occur between 
successive VBL interrupts is limited to the distance someone can move a 
mouse in one-sixtieth of a second. 

Button Interrupt Mode 

The Apple lie mouse-button hardware location does not generate interrupts. 
However, a program can simulate mouse-button interrupts by polling the 
button whenever VBlInt occurs, and acting on the interrupt whenever the 
button state has changed. This lets your program provide fast response to 
the mouse movement without too much program overhead. 

Movement/Button Interrupt Mode 

The movement/button interrupt mode is a combination of the two modes 
just described. It provides the best response possible without constant 
polling of the mouse position and button. Your program can effectively 
process a main task concurrently with cursor and menu updating, as well as 
menu-selected command processing. 

Vertical Blanking Active Modes 

The vertical blanking active modes are the same as the four just described 
except that they allow VBL interrupts to be sent to the user. 


9.1.3 Mouse Soft Switches 


The soft switches assigned to the mouse interface are shown in Table 9-2. 
On power-up or reset, the hardware selects the rising edge of XO and YO 
(mouse movement signals) and masks out all mouse interrupts. 

Table 9-2 is included here for your information only. You should use the 
built-in firmware to access the mouse; doing so is much easier than 
writing your own mouse interrupt handler, and guarantees compatibility 
with all other Apple II series computers. 
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Table 9-2. Mouse Soft Switches 


Name 

Action 

Hex 

Function 

IOUDis 

W 

$C07E 

On: Disable IOU access for addresses $C058 to 
$C05F; enable access to DHiRes switch’ 1 ' 

IOUDis 

W 

$C07F 

Off: Enable IOU access for addresses $0058 to 
$C05F; disable access to DHiRes switch* 

RdlOUDis 

R7 

$C07E 

Read IOUDis switch (1 = off)** 

DisXY 

R/W 

$C058 

Disable (mask) XO and YO movement 
interrupts*** 

EnbXY 

R/W 

$C059 

Enable (allow) XO and YO movement 
interrupts*** 

RdXYMsk 

R7 

SC040 

Read status of XO/YO interrupt mask 
(1 = mask on) 

RstXY 

R 

$C048 

Reset XO/YO interrupt flags 

XOEdge 

R/W 

$C05C 

Select rising edge of XO for interrupt*** 

XOEdge 

R/W 

SC05D 

Select falling edge of XO for interrupt*** 

RdXOEdge 

R7 

$C042 

Read status of XO edge selector (1 = falling) 

RstXInt 

R 

$C015 

Reset mouse XO interrupt flag 

YOEdge 

R/W 

$C05E 

Select rising edge of YO for interrupt*** 

YOEdge 

R/W 

$C05F 

Select falling edge of YO for interrupt*** 

RdYOEdge 

R7 

$C043 

Read status of YO edge selector (1 = falling) 

RstYInt 

R 

$C017 

Reset mouse YO interrupt flag 

DisVBl 

R/W 

$C05A 

Disable (mask) VBL interrupts*** 

EnVBl 

R/W 

$C05B 

Enable (allow) VBL interrupts*** 

RdVBIMsk 

R7 

$C041 

Read status of VBL interrupt mask (1 = mask 
on) 

RstVBl 

R 

$C019 

Read and then reset VBlInt flag 

PTrig 

R/W 

$C070 

Reset VBlInt flag; trigger paddle timer 
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Table 9-2 — continued. Mouse Soft Switches 


Name 

Action 

Hex 

Function 

RdBtnO 

R7 

$C061 

Read first mouse button status (1 = pressed)t 

Rd63 

R7 

$C063 

Read second mouse button status 
(0 = pressed)! 

MouXl 

R7 

$C066 

Read status of XI (mouse X direction) 

(1 = high) 

MouYl 

R7 

$C067 

Read status of Y1 (mouse Y direction) 

(1 = high) 


* When IOUDis is on, $C058-$C05F do not affect mouse, and SC05E and $C05F become 
DHiRes (Table 5-8). 

** Read or write to $C07x also resets VBlInt and triggers paddle timers. 

*** These work only if IOUDis is off. 

t This location is also the [3] key (Table 4-1). 

t This is also the location of the shift-key mod (Appendix F). 


Mouse firmware sets interrupts in response to mode settings under program 
control. The vertical blanking interrupt (VBlInt) is armed if the mouse 
button is pushed or moves at least a count of 1 in the XO or YO coordinates. 
Read $C070 to reset the VBL interrupt. Because a VBL occurs every sixtieth 
of a second, that is the maximum time that can elapse before the resulting 
interrupt can be acknowledged and acted upon. 

Software can also select which edge of XO and YO information will cause the 
XInt or YInt. 

When an interrupt has occurred, you can read the direction of the mouse’s 
XI movement by reading address $C066 bit 7, and Y1 movement by reading 
address $C067 bit 7. 

A program can read the status of the soft switches by reading one of the 
locations $C040-$C043 and then testing data bit 7. 

Section 11.12 explains what XO, YO, XI, Y1 are and what they mean with 
respect to mouse movement. 

If you write your own mouse interrupt handler, it should enable the main 
bank-switched memory, set up its own IRQ vectors at addresses $FFFE and 
$FFFF, keep track of video modes and the alternate stack, and check for 
the interrupt source in the same manner as the mouse firmware listed in 
Appendix I, beginning at address $C400. 


178 


Chapter 9: Mouse and Game Input 


The 32K ROM includes a new feature for programs that need to use 
mouse interrupts for their own purposes. If your program sets bit 7 of the 
mouse port mode byte at I07FC to 1, mouse movement interrupts will be 
passed to the interrupt handler of your program. VBL interrupts will still 
be handled by the Apple He’s firmware. You should use this feature only 
if the mouse firmware can’t keep up with your needs. 


9.1.4 I/O Firmware Support for Mouse Input 

The Apple lie supports the mouse with firmware starting at address $C400. 
This firmware is necessary because the mouse requires fast, transparent 
interrupt processing to work effectively. 

In assembly language you can use direct firmware support for sophisticated 
mouse applications. To enable the mouse, first load a mode byte into the 
accumulator (and $C4 in X, $40 in Y), and then do a JSR to the firmware 
routine called SetMouse (Table 9-3). Valid mode bytes are the following: 

$00 Turns mouse off. 

$01 Sets transparent mode. 

$03 Sets movement interrupt mode. 

$05 Sets button interrupt mode. 

$07 Sets movement or button interrupt mode. 

$08 Turns mouse off, VBlInt active. 

$09 Sets transparent mode, VBlInt active. 

$0B Sets movement interrupt mode, VBlInt active. 

$0D Sets button interrupt mode, VBlInt active. 

$0F Sets movement or button interrupt mode, VBlInt active. 

The firmware then initializes the mouse. To read the current position and 
status of the mouse, first load $C4 into the X register, load $40 into the Y 
register, save processor status, disable interrupts, and then JSR to the 
firmware routine called ReadMouse (Table 9-3), which stores the 
information in the port 4 screen holes (Table 9-5). 

Table 9-3 lists the mouse port firmware routine offsets. Each address 
contains the low byte of the entry point of the routine described. The calling 
setup for all routines (except ServeMouse) is the same: the X register must 
contain $C4, and the Y register must contain $40. When the routine has 
finished, the A, X, and Y register contents are undefined. 
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Table 9-3. Mouse Firmware Routines 


Location Offset for 

Description 

$C412 SetMouse 

Sets the mouse mode to the value in the accumulator. 
Input: A register contains mode (see S07FC, Table 9-5). 
Output: Carry bit = 0 means mode was legal; carry 
bit = 1 means mode was not legal. 

$C413 ServeMouse 

Services mouse interrupt if needed. 

Input: X, Y, A registers— doesn’t matter. 

Output: Carry bit = 0 means mouse caused the 
interrupt; carry bit = 1 means something else caused it. 
This routine updates $0770 to show which event 
caused the interrupt (values in Table 9-5). 

$C414 ReadMouse 

Updates screen holes to show current mouse 

X-Y position and button status; clears VBlInt, button 
and movement interrupt bits in the status byte. Doesn’t 
reenable interrupts until after retrieving position 
values. 

Output: Carry bit = 0. 

$C415 ClearMouse 

Sets the mouse position to 0, though not necessarily 
within clamping boundaries; leaves button and 
interrupt bits in status byte unchanged. 

Output: Carry bit = 0. 

$C416 PosMouse 

Sets the mouse coordinates to new values. 

Input: X and Y screen holes contain new X and Y 
positions. 

Output: Carry bit = 0. 


$C417 ClampMouse Sets new clamping boundaries (see Table 9-5). Does 
not affect mouse position or update mouse position 


SC418 HomeMouse 

screen holes; use ReadMouse to do that. 

Input: A register = 0 means set new X boundaries; 

A register = 1 means set new Y boundaries. 

Output: Carry bit = 0. 

Sets the internal mouse position to the upper-left 
corner of the clamping window. Does not update mouse 
position screen holes; use ReadMouse to do that. 

$C419 InitMouse 

Sets startup internal values; does not update 
mouse-position screen holes. 

Output: Carry bit = 0. 


Here is a sample sequence of events and calls: 
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1. Four screen holes contain the mouse’s X and Y coordinates, and one 
contains the status of the last mouse movement (Table 9-5). 

2 . Call InitMouse. 

3 . Inhibit interrupts, set up the boundaries you want, then call 
ClampMouse. 

4 . Use PosMouse, HomeMouse, or ClearMouse to position the mouse where 
you want it. 

5 . Put the mouse mode (see address $07FC in Table 9-5) that you want to 
use in the accumulator, then call SetMouse. 

6 . If you have set one of the interrupt modes, then when an interrupt 
arrives, call ServeMouse to determine the source of the interrupt. 

7 . Disable interrupts and call ReadMouse. Retrieve the position values, 
then reenable interrupts. 

Pascal Support 

Table 9-4 lists the locations and values of the I/O firmware protocol that 

Pascal 1.1 and later versions use. However, Pascal must use a special attach 

driver to support the mouse. 

Table 9-4. Mouse Port I/O Firmware Protocol 


Address 

Value 

Description 

$C405 

$38 

Pascal ID byte 

$C407 

$18 

Pascal ID byte 

$C40B 

$01 

Generic signature byte of firmware cards 

$C40C 

$20 

2 = X-Y pointing device; 0 = identification code 

$C40D 


Initialization routine (not implemented; returns 
error code) 

$C40E 


Standard read routine (not implemented; returns 
error code) 

$C40F 


Standard write routine (not implemented; 
returns error code) 

$C410 


Standard status routine (not implemented; 
returns error code) 

$C411 

$00 

Optional routines follow 

$C4FB 

$D6 

A mouse identification byte 
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BASIC and Assembly-Language Support 


In BASIC, you must turn the mouse on by printing PR#4 and then CHR$(1) 
before you can get input from the mouse. This sets transparent mode. After 
that, reenable video output with PR#3, and take subsequent input from the 
mouse by issuing IN#4. The first input statement after that (INPUT X,Y,S) 
initializes and enables the mouse, and returns a three-element string 

+xxxx,+yyyy,+st 

representing the x-coordinate, y-coordinate, and status digits. 

The coordinates will be integers between 0 and +1023. These are called the 
clamping boundaries of the mouse. 

The sign preceding the status digits is normally positive; it becomes 
negative when you press a key on the keyboard. 

The first digit, s, of the status is 0. The second digit, t, of the status is 1 if the 
mouse button is still pressed, 2 if it was just pressed, 3 if it was just 
released, and 4 if it is still released. 

To disable the mouse, use these statements: 

PRINT CHR$(‘0"PR*4" 

PRINT CHR$ C 0 ) 

PRINT CHRC4V , PR*3 M 


9.1.5 Screen Holes 


Table 9-5 lists the screen holes that the mouse firmware uses. Note that the 
mouse firmware reserves port 5 screen holes for its own use. Also, the 
auxiliary page counterparts of the port 4 addresses are reserved for startup 
values. 


Important! 


Some screen holes are different for the Apple He mouse. Refer to 
Appendix F. 


Table 9-5. Mouse Port Screen Hole Locations 


Scratch Area: 

Location Description 


$0478 Low byte of clamping minimum 

$04F8 Low byte of clamping maximum 

$0578 High byte of clamping mimimum 

$05F8 High byte of clamping maximum 
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Table 9-5 — continued. Mouse Port Screen Hole Locations 


Port 4 Screen Holes: 

Location Description 

$047C Low byte of X coordinate 

$04FC Low byte of Y coordinate 

$057C High byte of X coordinate 

$05FC High byte of Y coordinate 

$067C Reserved 

$06FC Reserved 

$077C Status byte 


Bit 1 Equals 

7 Button down 

6 Button was down on last read and still down 

5 Movement since last read 

4 Reserved 

3 Interrupt from VBlInt 

2 Interrupt from button 

1 Interrupt from movement 

0 Reserved 

$07FC Mode byte (current mode; mask out bits 4-7 when testing) 

Bit 1 Equals 

7-4 Reserved 

3 VBlInt active 

2 VBL interrupt on button 

1 VBL interrupt on movement 

0 Mouse active 


Port 5 Screen Holes: 
Reserved 


9.1.6 Using the Mouse as a Hand Controller 

You can use the mouse as if it were a set of hand controllers or an 
X-Y pointing device in port 4. If you turn the mouse on, the Monitor hand 
controller (game paddle) routines take input from the mouse. This is 
possible because the mouse and the hand controllers all use the same back 
panel connector. 
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Important! 


You can run a BASIC program that uses the Pdl function to read from the 
mouse by doing the following, either from the keyboard or from a program: 

1. Start up the system with the BASIC program that uses paddles. 

2 . Type p r * 4 and press | return | to turn on the mouse. 

3. Press | control H~a~1 1 return | to initialize the mouse. 

4. Type pr*0 and press | return | to restore output to the screen. 

5. RUN the program. 

Play the game using the mouse instead of the paddles. 

Many copy-protected games do not work with a mouse. Also, many games 
don’t use built-in firmware for the paddles. 


9.2 Game Input 

The Apple lie supports game paddles, joysticks, and other hand controllers 
connected to the DB-9 connector on its back panel. Table 9-6 is a summary 
of game input characteristics. 

Table 9-6. Game Input Characteristics 

Port number: None 

Commands: None 

Initial 

characteristics: Game inputs cannot be disabled. 

Hardware page locations: 

$C061 Switch input 0 and [5] 

$C062 Switch input 1 and [1] 

$C063 Mouse button (sense is opposite that of $C061 to distinguish 

it from paddle button) 

$C064 Analog input (paddle) 0 

$C065 Analog input (paddle) 1 

$C070 Trigger paddle timer 
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Table 9-6— continued. Game Input Characteristics 


Complete electrical specifications of these 
inputs are given in Chapter 11; Table 11-22 
shows the connector pin numbers. 


Monitor firmware routines: 

Location Name Description 

$FB1E PRead Reads a paddle position 

I/O firmware entry points: None 
Use of screen holes: None 


9.2.1 The Hand Controller Connector Signals 

Several inputs are available to programs or devices from the 9-pin D-type 
miniature connector on the back of the Apple lie: two 1-bit inputs, or 
switches, and two analog inputs. 

When you connect a pair of hand controllers to the 9-pin connector, the 
rotary controllers use two analog inputs, and the pushbuttons use two 1-bit 
inputs. However, you can also use these inputs for many other jobs. For 
example, two analog inputs can be used with a two-axis joystick. 

Switch Inputs (S wO and Swl) 

The two 1-bit inputs can be connected to the output of another electronic 
device that meets the electrical requirements described in Chapter 11, or to 
a pushbutton. When you read a byte from one of these locations, only the 
high-order bit— bit 7— is valid information; the rest of the byte is undefined. 
From machine language, you can do a Branch Plus or Branch Minus on the 
state of bit 7. From BASIC, you can read the switch with a PEEK and 
compare the value with 128. If the value is 128 or greater, the switch is on. 

The memory locations for these switches are $C061, $C062, and $C063 
(decimal locations 49249 through 49251), as shown in Table 9-6. Switch 0 
and switch 1 are permanently connected to [3] and [ff] on the keyboard; 
these are the ones connected to the buttons on the hand controllers. 
Location $C063 is a second address for the mouse button, so that a program 
can distinguish it from an [3] keypress. When the mouse button is pressed, 
$C063 (bit 7) goes from 1 to 0, and $C061 (bit 7) goes from 0 to 1. 
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Analog Inputs (PdIO and Pdll) 


The two analog inputs are designed for use with 150-Kft variable resistors or 
potentiometers. The variable resistance is connected between the 
+5V supply and each input, so that it makes up part of a timing circuit 
(refer to Section 11.13 for details). The circuit changes state when its time 
constant has elapsed, and the time constant varies as the resistance varies. 
Your program can measure this time by counting in a loop until the circuit 
changes state, or times out. 

A program must first reset the timing circuits before it can read the analog 
inputs. Accessing memory location $C070 does this. As soon as you reset the 
timing circuits, the high bits of the bytes at locations $C064 through $C067 
are set to 1. If you PEEK at them from BASIC (locations 49252 through 
49255), the values will be 128 or greater. Within about three milliseconds, 
these bits will change back to 0— byte values less than 128— and remain 
there until you reset the timing circuits again. The exact amount of time 
each of the bits remains high is directly proportional to the resistance 
connected to the corresponding input. If these inputs are open— no 
resistances are connected— the corresponding bits may remain high 
indefinitely. 


9.2.2 Monitor Support for Game Input 

To read the analog inputs from machine language, you can use a program 
loop that resets the timers and then increments a counter until the bit at the 
appropriate memory location changes to 0, or you can use the built-in 
routine PRead. BASIC and other high-level languages also include 
convenient means of reading the analog inputs— refer to your language 
manuals. You can read and reread the same paddle at arbitrarily short 
intervals. However, you must wait at least three milliseconds between 
reading one paddle and reading a different paddle. 


▲Warning 


The Monitor routine PRead (at address $FB1E) places in the Y register a 
number between $00 and $FF that represents the position of a hand 
controller. You pass the number of the hand controller in the X register. 

If the hand controller number you furnish in the X register does not 
equal 0 or 1, strange things may happen. 


The paddle and vertical blanking both use $C070. Disable interrupts 
before calling PRead if you are reading the paddles and using VBL 
interrupts. 
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Chapter 10 


Using the Monitor 
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The System Monitor is a set of subroutines in the Apple lie firmware that 
provides a standard interface to the built-in I/O devices described in 
Chapter 1. Many of the I/O subroutines described in Chapters 3 through 9 
are part of the System Monitor. 

DOS (but not ProDOS) and the BASIC interpreters (Appendix E) use these 
subroutines by direct calls to their starting locations. You can call the 
standard subroutines from your programs in the same fashion. The starting 
addresses for all of the standard subroutines are listed in Appendix C. 

You can perform most of the Monitor functions directly from the keyboard. 
This chapter tells you how to use the Monitor 

□ to look at one or more memory locations 

□ to change the contents of any location 

□ to write small programs in machine language to be executed directly by 
the Apple lie 

□ to move and compare blocks of memory 

□ to invoke other programs from the Monitor. 


10.1 Invoking the Monitor 


The positive and negative decimal 
equivalents of Monitor locations are listed 
in Appendix C. In addition, Appendix H 
contains conversion tables from one 
numbering system to another. Appendix E 
gives further details on how to use Apple lie 
firmware from BASIC programs. 


The System Monitor starts at memory location $FF69 (-151). To invoke the 
Monitor, you make a CALL -151 statement to this location from the 
keyboard or from a BASIC program. When the Monitor is running, its 
prompting character, an asterisk (*), appears on the left side of the display 
screen, followed by a cursor. 

To use the Monitor, you type commands at the keyboard. When you have 
finished using the Monitor, you return to the BASIC language you were 
previously using by pressing | control H reset I . by pressing 
I control hfcl and then | return l , or by typing 3D0G, which executes the 
resident program— usually Applesoft— whose address is stored in a jump 
instruction at location $03D0. 


Important! 


If ProDOS (or DOS) is connected via the standard I/O links (Chapter 3), 
then you can issue commands to it from the Monitor. Under this 
arrangement, errors will return control to BASIC rather than to the 
Monitor. 


If you want to have | control H reset l return you to the Monitor, load the 
values $69, $FF, and $5A (decimal 105, 255, and 90) into the three locations 
starting at address $03F2 (decimal 1010, the reset-vector address and the 
power-up byte). 
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10.2 Syntax of Monitor Commands 


To give a command to the Monitor, you type a line on the keyboard, then 
press | return | . The Monitor accepts the line using the standard I/O 
subroutine GetLn described in Chapter 3. A Monitor command can be up to 
255 characters in length, ending with a carriage return. It can include three 
kinds of information: addresses, data values, and command characters. You 
type addresses and data values in hexadecimal notation. 

When the command you type calls for an address, the Monitor accepts any 
group of hexadecimal digits. If there are fewer than four digits in the group, 
it adds leading Os; if there are more than four hexadecimal digits, the 
Monitor uses only the last four digits. It follows a similar procedure when 
the command syntax calls for two-digit data values. 

Each command you type consists of one command character, usually the 
first letter of the command name. The Monitor recognizes 22 different 
command characters. Some of them are punctuation marks, some are 
letters (uppercase or lowercase), and some are control characters. 

Note: Although the Monitor recognizes and interprets them, control 
characters typed on an input line do not appear on the screen. 

This chapter contains examples of Monitor command use. Some of the data 
values displayed by your Apple lie may differ from the values printed in 
these examples, because they are variables stored in RAM. 


10.3 Monitor Memory Commands 


When you use the Monitor to examine and change the contents of memory, 
it keeps track of the address of the last location whose value you inquired 
about and the address of the location that is next to have its value changed. 
These are called the last opened location and the next changeable location. 


AWarning 


Because locations $C000 through $COFF contain special hardware 
circuits, issuing any command that reads or writes on this page can have 
unpredictable, and perhaps disastrous, results. 
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10.3.1 Examining Memory Contents 


When you type the address of a memory location and press | return | , the 
Monitor responds with the address you typed, a dash, a space, and the value 
stored at that location, like this: 

*E000 

E000- 4C 
*33 

0033- AA 
* 

Each time the Monitor displays the value stored at a location, it saves that 
address as the last opened location and as the next changeable location. 


10.3.2 Memory Dump 

When you type a period (.) followed by an address, and then press 
I return | , the Monitor displays a memory dump: the data values stored at 
all the memory locations from the one following the last opened location to 
the location whose address you typed following the period. The Monitor 
saves the last location displayed as both the last opened location and the 
next changeable location. In these examples, the amount of data displayed 
by the Monitor depends on how much larger the address after the period is 
than the last opened location. 

*20 

0020 - 00 
* . 2B 

0021- 28 00 18 0F 0C 00 00 

0028- A8 06 D0 07 

*300 


0300- 99 
*.315 


0301 - 

B9 

00 

08 

0 A 

0 A 

0 A 

99 

0308- 

00 

08 

C8 

D0 

F 4 

A6 

2B A9 

0310- 

09 

85 

27 

AD 

CC 

03 



* . 32A 
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0316- 85 41 

0318- 84 40 8A 4A 4A 4A 4A 09 
0320- C0 85 3F A9 5D 85 3E 20 

0328- 43 03 20 
# 

When the Monitor performs a memory dump, it starts at the address 
immediately following the last opened location and displays that address 
and the data value stored there. It then displays the values of successive 
locations up to and including the location whose address you typed, but 
only up to eight values on a line. When it reaches a location whose address 
is a multiple of 8— that is, one that ends with an 8 or a 0— it displays that 
address as the beginning of a new line, then continues displaying more 
values. 

After the Monitor has displayed the value at the location whose address you 
specified in the command, it stops the memory dump and sets that location 
as both the last opened location and the next changeable location. If the 
address specified on the input line is less than the address of the last 
opened location, the Monitor displays only the address and value of the 
location following the last opened location. 

You can combine the two commands, opening a location and dumping 
memory, by concatenating them: type the first address, a period, and the 
second address. This combination of two addresses separated by a period is 
called a memory range. 

*300 .32F 


0300- 

99 

B9 

00 

08 

0 A 

0 A 

0 A 

99 

0308- 

00 

08 

C8 

D0 

F 4 

A6 

2B 

A9 

0310- 

09 

85 

27 

AD 

CC 

03 

85 

41 

0318- 

84 

40 

8A 

4 A 

4 A 

4 A 

4 A 

09 

0320- 

C0 

85 

3F 

A9 

5D 

85 

3E 

20 

0328- 

43 

03 

20 

46 

03 

A5 

3D 

4D 

*30.40 








0030- 

AA 

00 

FF 

AA 

05 

C2 

05 

C2 

0038- 

IB 

FD 

D0 

03 

3C 

00 

40 

00 

0040- 

30 








*E0 1 5 . 

E025 







E015- 

4C 

ED 

FD 






E018- 

A9 

20 

C5 

24 

B0 

0C 

A9 

8D 

E020- 

A0 

07 

20 

ED 

FD 

A9 
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Pressing | return I by itself makes the Monitor display one line of a memory 
dump; that is, a memory dump from the location following the last opened 
location to the next multiple-of-8 boundary. The Monitor saves the address 
of the last location displayed as both the last opened location and the next 
changeable location. 

*5 

000 5 - 00 
* | RETURN | 

00 00 
* | RETURN 1 

0008- 00 00 00 00 00 00 00 00 
*32 

0032- FF 
* | RETURN | 

aa 00 C2 05 C2 

♦ | RETURN | 

0038- IB FD D0 03 3C 00 3F 00 


10.3.3 Changing Memory Contents 

Section 10.3.2 showed you how to display values stored in the Apple He’s 
memory; this section shows you how to change these values. You can 
change any location in RAM; you can change the characteristics and 
treatment of an output device by changing the contents of locations 
assigned to it; and you can change a soft switch setting by referencing its 
set and reset addresses. 


▲Warning 


Use these commands carefully. If you change the zero-page locations 
used by the interpreter or operating system (Appendix B), you may lose 
programs or data stored in memory. 


Changing One Byte 

The previous commands keep track of the next changeable location; these 
commands make use of it. In the next example, you open location 0, then 
type a colon followed by a value. 

*0 
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0000- 4C 
* : BF 

The contents of the next changeable location have just been changed to the 
value you typed, as you can see by examining that location: 

*0 


0000- 5F 
* 

You can also combine opening and changing into one operation by typing an 
address followed by a colon and a value. In the example, you type the 
address again to verify the change. 

*302:42 

*302 

0302- 42 
# 

When you change the contents of a location, the value that was contained 
in that location is replaced by the new value, which will remain until you or 
some program replaces it with another value. 

ASCII Input Mode: The Monitor has a tool to make entering values a 
little easier: ASCII input mode. ASCII input mode lets you enter ASCII 
characters as well as their hexadecimal ASCII equivalents. This means 
that ' A is the same as Cl and ' B is the same as C2 to the Monitor. The 
ASCII value for any character following an apostrophe is used by the 
Monitor. For example, to enter the string “Good morning!” at $0300 in 
memory, type 

*300 : 'G 'o 'o 'd ' 'm 'o 'r ' n 'i ' n 'g '! 

Note that each character to be placed in memory is delimited by a leading 
and a trailing space. The only exception to this rule is that the last 
character in the line is followed by a RETURN character instead of a 
space. 

Changing Consecutive Locations 

You don’t have to type a separate command with an address, a colon, a 
value, and press | return | for each location you want to change. You can 
change the values of up to 85 consecutive locations at a time— or even 
more, if you omit leading Os from the values— by typing only the initial 
address and colon followed by all the values separated by spaces; end with 
I return | . The Monitor stores the consecutive values in consecutive 
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locations, starting at the location whose address you typed. After it has 
processed the string of values, it takes the location following the last 
changed location as the next changeable location. Thus, you can continue 
changing consecutive locations, without typing an address on the next 
input line, by typing another colon and more values. In these examples, you 
first change some locations, then examine them to verify the changes. 

*300:69 01 20 ED FD 4C 03 
*300 

0300- 69 
* | RETURN | 

01 20 ED FD 4C 00 03 
*10:0 1 2 3 

* : 4 5 6 7 

*10.17 

0010- 00 01 02 03 04 05 06 07 


10.3.4 Moving Data in Memory 

You can copy a contiguous block of data from one area in the Apple He’s 
memory to another in RAM by using the Monitor’s MOVE command. To 
move a range of memory, you must tell the Monitor both where the data is 
now situated in memory— the source locations— and where you want the 
copy to go— the destination locations. 

The format of the complete MOVE command looks like this: 

{destination! < {start} . {end} [m] 

The destination is the address where you want the first of the moved data 
to go. The less-than symbol (<) separates the destination address from the 
starting and ending addresses of the block of data to be moved. The period 
between two addresses is the Monitor’s standard notation for specifying 
address ranges. If the second address in the source range specification is 
less than the first, then only one value (that of the first location in the 
range) will be moved. 
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See Section 10.6 for an interesting 
application of this feature. 


When you type the actual command, replace the words in braces with 
hexadecimal addresses, and omit the braces and spaces. Here are some 
examples of memory moves. First, you examine the values stored in one 
range of memory, then store several values in another range of memory. 

The actual MOVE commands end with fMl . 

*0 .F 

0000- 5F 00 05 07 00 00 00 00 
0008- 00 00 00 00 00 00 00 00 
*300 : A9 8D 20 ED FD A9 45 20 DA FD 4C 00 03 

*300. 30C 

0300- A9 8D 20 ED FD A9 45 20 
0308- DA FD 4C 00 03 
*0<300.30C |~M~1 

*0 .C 

0000- A9 8D 20 ED FD A9 45 20 
0008- DA FD 4C 00 03 
*3 1 0 <8 . A |~M~| 

*310.312 

0310- DA FD 4C 
*2<7 . 9 |~M~1 

*0.C 

0000- A9 8D 20 DA FD A9 45 20 
0008- DA FD 4C 00 03 
* 

The Monitor moves a copy of the data stored in the source range of locations 
to the destination locations. The values in the source range are left 
undisturbed. The Monitor remembers the last location in the source range 
as the last opened location, and the first location in the source range as the 
next changeable location. 

If the destination address of the MOVE command is inside the source range 
of addresses, then strange things happen: the locations between the 
beginning of the source range and the destination address are treated as a 
subrange and the values in this subrange are replicated throughout the 
source range. Try it. 
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10.3.5 Comparing Data in Memory 


You can use the VERIFY command to compare two ranges of memory using 
the same format you use to move a range of memory from one place to 
another. In fact, the VERIFY command can be used immediately after a 
MOVE to make sure that the move was successful. 

The VERIFY command, like the MOVE command, needs a range and a 
destination. The syntax of the VERIFY command is 

{destination} < {start} . |end{ [7] 

The Monitor compares the values in the source locations with the values in 
the locations beginning at the destination address. If any values don’t 
match, the Monitor displays the address at which the discrepancy was 
found and the two values that differ. In the example, you store data values 
in the range of locations from 0 to $0D, copy them to locations starting 
at $0300 with the MOVE command, and then compare them using the 
VERIFY command. When you use the VERIFY command after you change 
the value at location 6 to $E4, it detects the change. 

*0:D7 F 2 E9 F4 F4 E5 EE A0 E2 F9 A0 C3 C4 C5 
*300<0 . D [~m! 

*30 0 < 0 . D [v] 

*6 : E4 

*30 0 < 0 . D [V] 

0006-E4 CEE) 

* 

If the VERIFY command finds a discrepancy, it displays the address of the 
location in the source range whose value differs from its counterpart in the 
destination range. If there is no discrepancy, VERIFY displays nothing. The 
VERIFY command leaves the values in both ranges unchanged. The last 
opened location is the last location in the source range, and the next 
changeable location is the first location in the source range, just as in the 
MOVE command. If the ending address of the range is less than the starting 
address, the values of only the first locations in the ranges are compared. 
Like the MOVE command, the VERIFY command does unusual things if the 
destination address is within the source range; see Section 10.6. 
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10.4 Monitor Register Commands 


Even though the actual contents of the 65C02’s internal registers are 
changing as you use the Monitor, you can examine the values that the 
registers contained at the time the Monitor gained control, either because 
you called it or because the program you are debugging stopped at a 
break (BRK). You can also store new register values that will be used when 
you execute a program from the Monitor using the GO command, described 
below. 


10.4.1 Changing Registers 

When you call the Monitor, it stores the contents of the 65C02 registers in 
memory. The registers are stored in the order A, X, Y, P (processor status 
register), and S (stack pointer), starting at location $45. When you give the 
Monitor a GO command, the Monitor loads the registers from these five 
locations before it executes the first instruction in your program. 


10.4.2 Examining Registers 

Pressing 1 control H~e~1 and then I return ] invokes the Monitor’s EXAMINE 
command, which displays the stored register values and sets the location 
containing the contents of the A register as the next changeable location. 
After using the EXAMINE command, you can change the values in these 
locations by typing a colon and then typing the new values separated by- 
spaces. In the following example, you display the registers, change the first 
two, and then display them again to verify the change. 

♦ I control H ~e~1 

M= 0 0 A = 0A X = FF V -D8 P>=B0 S = F8 
* : B0 02 

« | CONTROL HD 

M- 0 0 A = B0 X = 02 Y = D8 P = B0 S = F8 


In the EXAMINE command’s display, M shows the current memory state 
register contents. The memory state register is location $44, and its 
interpretation is given in Section E.4 of Appendix E. 
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The COut subroutine is described in 
Chapter 3. 


See Appendix D. 


Important! 


10.5 Miscellaneous Monitor Commands 


Monitor commands discussed in this section let you do the following: 

□ change the video display format from normal to inverse and back 

□ assign input and output to various devices 

□ leave the Monitor and return to the currently-loaded operating system 
(DOS 3.3 or ProDOS) or BASIC 

10.5.1 Display Inverse and Normal 

You can control the setting of the inverse-normal mask location used by the 
COut subroutine from the Monitor so that all the Monitor’s output will be in 
inverse format. The INVERSE command (I) sets the mask so that all 
subsequent inputs and outputs are displayed in inverse format. To switch 
the Monitor’s output back to normal format, use the NORMAL 
command (N). 

* 0 . F 

0000- 0 A 0B 0C 0D 0E 0F 00 04 

0008- C6 01 F 0 08 CA D0 F6 AS 

*CD 

* 0 . F 

0000- 0 A 0B 0C 0D 0 E 0F D0 04 

0008- CS 01 F 0 08 CA D0 FS AG 

*[EI 

*0 .F 

0000- 0 A 0B 0C 0D 0E 0F D0 04 

0008- C6 01 F0 08 CA D0 F6 AG 

* 


10.5.2 Back to BASIC 

If you are using one of the Apple disk operating systems (ProDOS or DOS), 
press | control H reset | or type 3D0G to return to the language you were 
using, with your program and variables intact. 

If you type the latter command, make sure that the third character you 
type is a zero, not a letter 0. The letter G is the Monitor’s GO command, 
described in Section 10.7. 
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Chapter 3 lists the Apple lie port numbers 
available. 


For more information on the way those 
commands work, refer to Section 3.1. 


If there is no operating system in RAM, use the BASIC command 
CONTROL-B to leave the Monitor and enter the BASIC interpreter that was 
active when you entered the Monitor. (Normally this is Applesoft BASIC.) 
Any program or variables that you had previously in BASIC will be lost. If 
you want to reenter BASIC with your previous program and variables 
intact, use the CONTINUE BASIC command (CONTROL-C). 


10.5.3 Redirecting Input and Output 

The CONTROL-P command diverts all output normally destined for the 
screen (port 0) to a device attached to one of the other ports, from 1 to 7. 
The format of the command is 

{port number} CONTROL-P 

A CONTROL-P command to port number 0 switches the stream of output 
characters back to the Apple He’s video display. However, use ESC 
CONTROL-Q if the enhanced video firmware is active (solid-block cursor). 

CONTROL-K controls the input stream in much the same way as 
CONTROL-P controls the output stream. The format for the command is 

{port numberj CONTROL-K 

Pressing (T) I control H JU1 directs the Monitor to accept input from the 
Apple He’s built-in keyboard. 

The CONTROL-P and CONTROL-K commands are the exact equivalents of 
the BASIC (but not DOS and ProDOS) commands PR# and IN#. 


10.5.4 Hexadecimal Arithmetic 

You can use the Monitor as a one-byte hexadecimal addition and subtraction 
calculator. Just type a line in one of these formats followed by I return | : 

{value} + {value} I return i 
{ value} — {value} I return | 

The Apple lie performs the arithmetic and displays the result, as shown in 
these examples. 

*20+13 

-33 

MA-C 

-3E 
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10.6 Advanced Operations 


This section describes some ways of using the Monitor commands to speed 
up your work. 


10.6.1 Multiple-Command Lines 


You can put as many Monitor commands on a single line as you like, as long 
as you separate them with spaces, and the total number of characters in the 
line is less than 254. Adjacent single-letter commands such as L, S, I, and N 
need not be separated by spaces. 

You can freely intermix all of the commands except the STORE (:) 
command. Since the Monitor takes all values following a colon and places 
them in consecutive memory locations, the last value in a STORE must be 
followed by a letter command before another address is encountered. You 
can use the NORMAL command as the required letter command in such 
cases; it usually has no effect and can be used anywhere. 

In the following example, you display a range of memory, change it, and 
display it again, all with one line of commands. 

*300.307 300:18 G9 1 |~N~| 300.302 

0300- 00 00 00 00 00 00 00 00 

0300- 18 89 01 
# 

If the Monitor encounters a character in the input line that it does not 
recognize as either a hexadecimal digit or a valid command character, it 
executes all the commands on the input line up to that character, then stops 
with a beep and ignores the remainder of the input line. 


10.6.2 Filling Memory 

The MOVE command can be used to replicate a pattern of values 
throughout a range of memory. To do this, first store the pattern in the first 
locations in the range: 

*300: 1 1 22 33 


Remember the number of values in the pattern: in this case, it is three. Use 
the number to compute addresses for the MOVE command, like this: 
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| start+number | < jstartj . |end-nuraber| [m] 

This MOVE command first replicates the pattern at the locations 
immediately following the original pattern, then replicates that pattern 
following itself, and so on until it fills the entire range. 

*303<300.32D |~M~1 
•300. 32F 

0300- 11 22 33 11 22 33 11 22 

0308- 33 11 22 33 11 22 33 11 

0310- 22 33 11 22 33 11 22 33 

0318- 11 22 33 11 22 33 11 22 

0320- 33 11 22 33 11 22 33 11 

0328- 22 33 11 22 33 11 22 33 

* 

You can use the VERIFY command to check whether a pattern repeats itself 
through memory. This is especially useful to verify that a given range of 
memory locations all contain the same value. In this example, to see the 
VERIFY command detect the discrepancy, you first fill the memory range 
from $0300 to $0320 with 0s and verify it, then change one location and 
verify again: 

*300 : 0 

*301<300.31F |~M~1 
*301<300 .31F |~V~1 
*304:02 

*301000. 31F[v] 

0303- 00 (02) 

0304- 02 (00) 


10.6.3 Repeating Commands 

You can create a command line that repeats one or more commands over 
and over. You do this by beginning the part of the command line that you 
want to repeat with a letter command, such as N, and ending it with the 
sequence 34:n, where n is a hexadecimal number that specifies the position 
in the line of the command where you want to start repeating; for the first 
character in the line, n=0. The value for n must be followed with a space in 
order for the loop to work properly. 
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This trick takes advantage of the fact that the Monitor uses an index 
register to step through the input buffer, starting at location $0200. Each 
time the Monitor executes a command, it stores the value of the index at 
location $34; when that command is finished, the Monitor reloads the index 
register with the value at location $34. By making the last command change 
the value at location $34, you change this index so that the Monitor picks up 
the next command character from an earlier point in the buffer. 

The only way to stop a loop like this is to press | control h reset I; that is 
how this example ends. 

*[n] 300 302 34:0 [n] 

0300- 11 
0302- 33 
0300- 11 
0302- 33 
0300- 11 
0302- 33 
0300- 11 
0302- 33 
0300- 11 
0302- 33 
0300- 11 
0302- 33 
030 


10.6.4 Creating Your Own Commands 

The USER command (CONTROL- Y) forces the Monitor to jump to memory 
location $03F8. You can put a JMP instruction there that jumps to your own 
machine-language program. Your program can then examine the Monitor’s 
registers and pointers or the input buffer itself to obtain its data. For 
example, here is a program that displays everything on the input line after 
the CONTROL-Y. The program starts at location $0300; the command line 
that starts with $03F8 stores a jump to $0300 at location $03F8. 

*30 0 : A4 34 B9 00 02 20 ED FD C8 C9 8D D0 F5 4C 89 FF 
*3F8:4C 00 03 

* 1 CONTROL K YI TH I S IS A TEST 
THIS IS A TEST 
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10.7 Machine-Language Programs 


The main reason to program in machine language is to get more speed and 
sometimes to also save memory space. A program in machine language can 
run much faster than the same program written in high-level languages 
such as BASIC or Pascal, but the machine-language version usually takes a 
lot longer to write. There are other reasons to use machine language: you 
might want your program to do something that isn’t included in your 
high-level language, or you might just enjoy the challenge of using machine 
language to work directly on the bits and bytes. 

Note: If you have never used machine language before, you’ll need to 
learn the 65C02 instructions listed in Appendix A. To become proficient 
at programming in machine language, you’ll have to spend some time at 
it, and study one of the books on 65C02 programming listed in the 
bibliography. 

You can get a hexadecimal dump of your program or move it around in 
memory using the commands described in the previous sections. The 
Monitor commands in this section are intended specifically for you to use in 
creating, writing, and debugging machine-language programs. 


10.7.1 Running a Program 

The Monitor command to start execution of your machine-language 
program is the GO command. When you type an address and press [g], the 
Apple lie starts executing machine-language instructions starting at the 
specified location. If you just press [g], execution starts at the last opened 
location. The Monitor treats this program as a subroutine: it should end with 
an RTS (return from subroutine) instruction to transfer control back to the 
Monitor. 

The Monitor has some special features that make it easier for you to write 
and debug machine-language programs, but before you get into that, here is 
a small machine-language program that you can run using only the simple 
Monitor commands already described. The program in the example merely 
displays the letters A through Z: you store it starting at location $0300, 
examine it to be sure you typed it correctly, then type 3 0 0 g to start it 
running. 

*30 0 : A9 Cl 20 ED FD 18 69 1 C9 DB D0 F6 60 
*300. 30C 
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0300- A9 Cl 20 ED FD 18 69 01 
0308- C9 DB D0 F6 60 
*300 [G] 

ABCDEFGH I JKLMNOPQRSTUVWX YZ 


10.7.2 Disassembled Programs 

Machine-language code in hexadecimal isn’t the easiest thing in the world 
to read and understand. To make this job a little easier, machine-language 
programs are usually written in assembly language and converted into 
machine-language code by programs called assemblers. 

Programs like the Monitor’s LIST command are called disassemblers. This 
command displays machine-language code in assembly-language form. 
Instead of unformatted hexadecimal gibberish, the LIST command displays 
each instruction on a separate line, with a three-letter instruction name, or 
mnemonic, and a formatted hexadecimal operand. The LIST command also 
converts the relative addresses used in branch instructions to absolute 
addresses. 

The Monitor LIST command has the format 
{locationj (T] 

The LIST command starts at the specified location and displays as much 
memory as it takes to make up a screenful (20 lines) of instructions, as 
shown in the following example: 

*300 |T] 


0300- 

A9 Cl 

LDA 

*$C1 

0302- 

20 ED FD 

JSR 

$ FDED 

0305- 

18 

CLC 


0306- 

69 0 1 

ADC 

*$01 

0308- 

C9 DB 

CMP 

*$DB 

030 A- 

D0 F6 

BNE 

$0302 

030C- 

60 

RTS 


030D- 

00 

BRK 


030E- 

00 

BRK 


030F- 

00 

BRK 


0310- 

00 

BRK 


0311- 

00 

BRK 
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0312- 

00 

BRK 

0313- 

00 

BRK 

0314- 

00 

BRK 

0315- 

00 

BRK 

0316- 

00 

BRK 

0317- 

00 

BRK 

0318- 

00 

BRK 

0319- 

00 

BRK 


* 


The first seven lines of this example are the assembly-language form of the 
program you typed in the previous example. The rest of the lines are BRK 
instructions only if this part of memory has Os in it: other values will be 
disassembled as other instructions. 

The Monitor saves the address that you specify in the LIST command, but 
not as the last opened location used by the other commands. Instead, the 
Monitor saves this address as the program counter, which it uses only to 
point to locations within programs. Whenever the Monitor performs a LIST 
command, it sets the program counter to point to the location immediately 
following the last location displayed on the screen, so that if you type 
another LIST command it displays another screenful of instructions, 
starting where the previous display left off. 
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UniDisk 3.5 


Section 10.8 applies only to the version of the Apple lie that supports 
UniDisk 3.5. 


STEP and TRACE are Monitor facilities for debugging assembly-language 
programs. The STEP command decodes, displays, and executes one 
instruction at a time, and the TRACE command steps continuously through 
a program, stopping when a BRK instruction is executed or [#] is pressed. 
You can press [3] to slow down the trace to one step per second. 

Each STEP command causes the Monitor to execute the instruction in 
memory pointed to by the program counter. The instruction is displayed in 
its disassembled form, then executed. The contents of the 65C02’s internal 
registers are displayed after the instruction is executed. After execution, the 
program counter is incremented to point to the next instruction in the 
program. 
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Here is an example of the STEP command, using the following program: 


$0300 

LDX #02 

$0302 

LDA $00, X 

$0304 

STA $10,X 

$0306 

DEX 

$0307 

STA $C030 

$ 030 A 

BPL $0302 

$ 030C 

BRK 


To step through this program, first call the Monitor by typing call - 1 5 1 
and pressing | return 1 , and then from the Monitor, type 3 0 0 s (to start the 
STEP routine at address $0300). Type s to advance each additional step 
through the program. The Monitor keeps the program counter and the last 
opened address separate from one another, so you can examine or change 
the contents of memory while you are stepping through your program. 

Here’s what happens when you step through the program above, examining 
the contents of location $0012 after the third step. Note that in this 
example, what you type appears just after the * prompt, and the 
information on the next two lines— that begin without the * prompt— is 
what the computer displays on the screen in response. 

*30 0S 


0300- A2 02 
M = CA A = 0 A X = 02 
*S 

0302- B5 00 
M = C A A = 0 C X = 0 2 
*S 

0304- 95 10 

M = CA A = 0C X = 0 2 
*12 

0012- 0C 
*S 

0306- CA 

M = CA A = 0C X = 0 1 

*S 


LDX #02 

Y = D8 P = 30 S = F8 

LDA $00, X 

Y = D8 P = 30 S = F8 

STA $10, X 
Y=D8 P=30 S=F8 


DEX 

Y = D8 P = 30 S = F8 


0307- 8D 30 C0 STA $C030 
M = CA A = 0 C X = 0 1 Y = D8 P = 30 S = F8 
*S 
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Important! 


UniDisk 3.5 


030 A- 10 F6 BPL $0302 
M = CA A = 0C X = 0 1 Y = D8 P = 30 S = F8 
*S 


0302- B5 00 LDA $00, X 
M=CA A=0B X = 01 Y = D8 P=30 S=F8 
*S 


0304- 95 10 STA $10, X 

M = CA A = 0B X = 0 1 Y = D8 P = 30 S = F8 


The TRACE command is a continuous version of the STEP command; it 
stops stepping through the program only when you press [T), or when it 
encounters a BRK instruction in the program. Press [3] to slow the trace to 
one step per second. 

Keep the following cautions in mind when using the STEP and TRACE 

Monitor commands: 

□ If the program ends with an RTS instruction, the TRACE routine will 
continue to run indefinitely until stopped with |T). 

□ You can’t step or trace through routines that use the same zero page 
locations as the Monitor. 


10.9 The Mini-Assembler 


Section 10.9 applies only to the version of the Apple lie that supports 
UniDisk 3.5. 

Without an assembler, you have to write your machine-language program, 
take the hexadecimal values for the opcodes and operands, and store them 
in memory using the Monitor commands described in Sections 10.1 through 
10.6 in this chapter. 

The Mini-Assembler lets you enter machine-language programs directly 
from the keyboard of your Apple. ASCII characters can be entered in 
Mini-Assembler programs, exactly as you enter them in the Monitor. 

Note that the Mini-Assembler doesn’t accept labels; you must use actual 
values and addresses. 


10.9 The Mini- Assembler 
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10.9.1 Starting the Mini-Assembler 


To start the Mini- Assembler, first invoke the Monitor by typing call - i 5 1 
I return 1 , and then from the Monitor, type ! followed by | return | . The 
Monitor prompt character then changes from * to • . 

When you finish using the Mini- Assembler, press | return | from a blank 
line to return to the Monitor. 

To enter code into memory, type the address, a colon, and the instruction. 
For example, after entering the Mini- Assembler, you could type: 

! 30 0 : STA C030 

You can enter a series of instructions by typing a space, followed by the 
instruction, followed by | return | : 

! 30 0 : STA C030 
! LDA #A0 
! I NX 

Each succeeding instruction is placed in the next available memory 
location. As you type in instructions, each is replaced by the starting 
address of the instruction, the hexadecimal value(s) of the instruction, 
followed by mnemonics describing the instruction. For example, the 
sequence of instructions given above would produce the following on your 


screen: 




0300- 

8D 30 C0 

STA 

$C030 

0303- 

A9 A 0 

LDA 

#$A 0 

030 S - 

E8 

I NX 



When you’re ready to execute your program, press | return I to leave the 
Mini- Assembler and return to the Monitor. Monitor commands can’t be 
executed directly from the Mini- Assembler. 


10.9.2 Using the Mini-Assembler 

The Mini-Assembler saves one address, that of the program counter. Before 
you start to type a program, you must set the program counter to point to 
the location where you want the Mini- Assembler to store your program. Do 
this by typing the address followed by a colon. 
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After the colon, type the mnemonic for the first instruction in your program, 
followed by a space and the operand of the instruction. Now press 
I return | . The Mini- Assembler converts the line you typed into 
hexadecimal, stores it in memory beginning at the location of the program 
counter, and then disassembles it again and displays the disassembled line. 
It then displays a prompt on the next line. 

Now the Mini-Assembler is ready to accept the second instruction in your 
program. To tell it that you want the next instruction to follow the first, 
don’t type an address or a colon: just type a space and the next instruction’s 
mnemonic and operand, then press I return | . The Mini-Assembler 
assembles that line and waits for another. 

If the line you type has an error in it, the Mini- Assembler beeps loudly and 
displays a caret ( * ) under or near the offending character in the input line. 
Most common errors are the result of typographical mistakes: misspelled 
mnemonics, missing parentheses, and so forth. The Mini-Assembler also 
rejects the input line if you forget the space before or after a mnemonic or 
include an extraneous character in a hexadecimal value or address. If the 
destination address of a branch instruction is out of the range of the branch 
(more than 127 locations distant from the address of the instruction), the 
Mini-Assembler flags this as an error. 

Dollar Signs: In this manual, dollar signs ($) in addresses signify that 
the addresses are in hexadecimal notation. The dollar signs are ignored 
by the Mini-Assembler and can be omitted in programs. 


•300: LDX *02 



0300- 

A2 02 

LDX 

*$02 

! LDA 

$00, X 



0302- 

BS 00 

LDA 

$00, X 

! STA 

$10, X 



0304 

95 10 

STA 

$10, X 

! DEX 




0306- 

CA 

DEX 


• STA 

$C030 



0307- 

8D 30 C0 

STA 

$C030 

! BPL 

$0302 



030 A- 

10 F6 

BPL 

$0302 

! BRK 




030 C - 

00 

BRK 



I 
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To leave the Mini- Assembler and reenter the Monitor, press | return I at a 
blank line. 


Your assembly-language program is now stored in memory. You can display 
it with the LIST command: 


*30 0L 





0300- 

A2 

02 

LDX 

*$02 

0302- 

B5 

00 

LDA 

$00, X 

0304- 

95 

10 

STA 

$10, X 

0306- 

CA 


DEX 


0307- 

8D 

30 C0 

STA 

$C030 

030 A- 

10 

F6 

BPL 

$0302 

030C- 

00 


BRK 


030D- 

00 


BRK 


030E- 

00 


BRK 


030F- 

00 


BRK 


0310- 

00 


BRK 


0311- 

00 


BRK 


0312- 

00 


BRK 


0313- 

00 


BRK 


0314- 

00 


BRK 


0316- 

00 


BRK 


0316- 

00 


BRK 


0317- 

00 


BRK 


0318- 

00 


BRK 


0319- 

00 


BRK 



10.9.3 Mini-Assembler Instruction Formats 


The Apple lie Mini-Assembler recognizes 66 mnemonics and 15 addressing 
formats. The mnemonics are standard, as used in th eSynertek 
Programming Manual (Apple part number A2L0003), but the addressing 
formats are somewhat different, as shown in Table 10-1. 

An address consists of one or more hexadecimal digits. The Mini-Assembler 
interprets addresses the same way the Monitor does: if an address has fewer 
than four digits, the Mini-Assembler adds leading Os; if the address has more 
than four digits, then it uses only the last four. 
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Table 10-1. Mini- Assembler Address Formats 


Addressing Mode 

Accumulator 
Implied 
Immediate 
Absolute 
Zero page 
Indexed zero page 


Format 


* 

* 


#${value} 


Relative 


Indexed indirect 
Indirect indexed 
Absolute indirect 


Indexed absolute 


${address} 

${address} 

$ ,X 

$ ,Y 

$ ,X 

$ ,Y 

${address} 

(${address},X) 

(${address}),Y 

(${address|) 



* These instructions have no operands. 


There is no syntactical distinction between the absolute and zero-page 
addressing inodes. If you give an instruction to the Mini-Assembler that can 
be used in both absolute and zero-page mode, the Mini- Assembler assembles 
that instruction in absolute mode if the operand for that instruction is 
greater than $FF, and it assembles it in zero-page mode if the operand is less 
than $0100. 

Instructions in accumulator mode and implied addressing mode need no 
operands. 

Branch instructions, which use the relative addressing mode, require the 
target address of the branch. The Mini- Assembler calculates the relative 
distance to use in the instruction automatically. If the target address is more 
than 127 locations distant from the instruction, the Mini-Assembler sounds 
a bell (beep), displays a caret ( * ) under the target address, and does not 
assemble the line. 

If you give the Mini- Assembler the mnemonic for an instruction and an 
operand, and the addressing mode of the operand cannot be used with the 
instruction you entered, then the Mini- Assembler will not accept the line. 
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10.10 Summary of Monitor Commands 


Here is a summary of the Monitor commands, showing the syntax diagram 
for each one. 


10.10.1 Examining Memory 


jadrs] | return I 


Displays the value contained in one 
location. 


jadrs l|.jadrs2j | return | 


I RETURN | 


jadrsj(T] 


Displays the values contained in all 
locations between jadrs 1} and 
jadrs2j. 

Displays the values in up to eight 
locations following the last opened 
location. 

Lists disassembled code starting at 
jadrs j and continuing until the 
screen is full. 


10.10.2 Changing the Contents of Memory 


jadrsj:jvalj jvalj... 


tjvaljjvalj... 


STORE command. Stores the values 
in consecutive memory locations 
starting at jadrs}. 

Stores values in memory starting at 
the next changeable location. 
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10.10.3 Moving and Comparing 


jdest[ < j start J . { end }C m] MOVE command. Copies the values 

in the range j start j.(end) into the 
range beginning at (destj. 

{dest) <jstart|.|endj(v] VERIFY command. Compares the 

values in the range jstart|. jend[ to 
those in the range beginning at 
| destj. 


10.10.4 The Register Command 


I control H Tj EXAMINE command. Displays the 

locations where the contents of the 
65C02’s registers are stored and 
opens them for changing. 


10.10.5 Miscellaneous Monitor Commands 


m 

INVERSE command. Sets inverse 
display mode. 

E 

NORMAL command. Sets normal 
display mode. 

1 CONTROL H B | 

BASIC command. Enters the 
language currently active (normally 
Applesoft). 

1 CONTROL hfcl 

CONTINUE BASIC command. 
Returns to the language currently 
active (normally Applesoft). 

jvalf+jvalj 

Adds the two values and prints the 
hexadecimal result. 

jvalf— |val} 

Subtracts the second value from the 
first and prints the result. 


10.10 Summary of Monitor Commands 


213 


(port} | CONTROL H ~P~1 


|~ESC~| fCONTROL H~Q~I 


jportj | CONTROL H~i<1 


I CONTROL K YI 


Redirects output to the device 
connected to port number jportj. If 
jportj =0, sends output to the video 
display. Use only when the 
enhanced video firmware is not 
active (checkerboard cursor). 

Redirects output to video display 
when enhanced video firmware is 
active (solid block cursor). 

Takes input from the device 
connected to port number jportj. If 
jportj =0, accepts input from the 
keyboard. 

USER command. Jumps to the 
machine-language subroutine at 
location S03F8. 


10.10.6 Running and Listing Programs 


{adrsjl~G~| 

Transfers control to the machine 
language program beginning at 
jadrsj. 

jadrsjft] 

Disassembles and displays 

20 instructions starting at jadrsj. 
Subsequent [p’s display 20 more 
instructions each. 
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Most of this manual describes functions— what the Apple lie does. This 
chapter, on the other hand, describes objects: the pieces of hardware the 
Apple lie uses to carry out its functions. If you are designing a device to 
connect to the Apple lie back panel, or if you just want to know more about 
how the Apple lie is built, you should study this chapter. 


11.1 Environmental Specifications 


The Apple lie is quite sturdy when used in the way it was intended— as a 
transportable computer, made for use in an indoor environment. You can 
carry it by its handle from room to room, but for longer trips you should use 
its carrying case or some other protective container (such as an attache 
case). 

Table 11-1 defines the conditions under which the Apple lie is designed to 
function properly. 


Table lbL Environmental Specifications 

Operating temperature: 10° to 40° C (50° to 104° F) 

Relative humidity: 20 % to 95 % 

Line voltage: 105 to 129 VAC (normal USA voltage range) 


You should treat the Apple lie with the same kind of care as any other 
electrical appliance; protect it from physical abuse, and be careful not to 
bump it against furniture when you move it around. Put it in an attache 
case or other protective covering if you carry it outside. You should also 
protect the mechanical keyboard and the electrical connectors inside the 
case from spilled liquids, particularly those with dissolved contaminants, 
such as soups, fruit juices, and carbonated soft drinks. 

In normal operation (with the handle locked in its down position), enough 
air flows through the openings in the case to keep the insides from getting 
too hot. If you do overheat your Apple lie— for example, by blocking the 
upper or lower ventilation openings— the first symptom will be erratic 
operation, such as unexpectedly changed data. (The memory devices in the 
Apple lie are especially sensitive to heat.) Letting the machine cool down by 
turning it off for a while and unblocking the vents before using it again will 
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bring it back to normal operation. The only exception to this is if you have 
gotten your Apple lie too hot and physically damaged some internal 
component. 

Disks are another heat-sensitive element of the system. If the built-in drive 
becomes too hot, a disk within can warp or even melt. A melted or warped 
disk can’t be used again. 


11.2 Power Requirements 


The electrical power used by the Apple lie— and everything that draws 
power from it— is limited by the capacities of the computer’s power supply 
and internal voltage converter. This section describes these limits for the 
USA external power supply. Appendix G describes them for models built for 
other countries. The internal voltage converter is the same on all models. 


11.2.1 The External Power Supply 

If you purchased your Apple lie outside the USA, consult Appendix G for 
external power supply characteristics. 


The external power supply operates on normal household AC power and 
provides DC power to the Apple lie internal converter. The basic 
specifications of the external power supply are listed in Table 11-2. The 
Apple lie external power supply’s cord must be plugged into a three- wire 
115- volt (nominal) outlet. A two- wire outlet is not properly grounded- 
using it will damage the external power supply and perhaps the Apple lie as 
well. The line voltage must be in the range given in Table 11-2. 


▲Warning 


Important Safety Instructions: This product is equipped with a 
three- wire grounding-type plug— a plug having a third (grounding) pin. 
This plug will only fit into a grounding-type AC outlet. This is a safety 
feature. 

If you are unable to insert the plug into the outlet, contact a licensed 
electrician to replace the outlet and, if necessary, install a grounding 
conductor. 

Do not defeat the purpose of the grounding-type plug. 


11.2 Power Requirements 
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Table 11-2. Power Supply Specifications 


Line voltage: 

Maximum input power 
consumption: 

Supply voltage: 

Supply current: 


105 to 129 VAC, 60 Hz 
25 W 

+15 VDC (nominal) 
1.2 A (nominal) 


11.2.2 The External Power Connector 

The external power supply is attached to the internal converter by means of 
a 7-pin DIN connector. The connector pins are identified in Figure 11-1 and 
Table 11-3. 


Figure ITT. External Power Connector 



1 Not connected 

2, 3 Signal ground 

4 Shield ground 

5,6 +15 VDC 

7 Not connected 


Table 11-3. External Power Connector Signals 


Pin# 

Name 

Description 

1,7 


Not connected 

2,3 

Ground 

Common electrical ground 

4 

Chassis 

Chassis ground 

5,6 

+15V 

+ 15-volt DC input to converter 
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11.2.3 The Internal Converter 


The internal converter in the Apple lie operates with a supply voltage from 
9 to 20 volts DC as provided by the external power supply or its equivalent. 
The internal converter provides enough low- voltage electrical power for the 
built-in electronics plus an external disk drive attached via the 19-pin 
connector. The basic specifications of the internal converter are listed in 
Table 11-4. Minus 5 volts is derived from the — 12 volts (nominal) provided 
by the voltage converter. 


Table 114. Internal Converter Specifications 


Input voltage: 

+9 to 20 VDC 

Maximum power consumption: 

25 W 


Supply voltages: 

+5V 

±5% 


+12V 

±10% 


-12V 

±10% 

Maximum supply currents: 

+5V: 

1.5 A 


+ 12V: 

0.6 A continuous 

0.9 A intermittent 

1.5 A surge (for < 100 ms) 


-12V: 

100 mA 


( — 5V: 

50 mA) 

Maximum case temperature: 

60° C 

(140° F) 


The Apple lie uses a switching-type internal voltage converter as a power 
supply. It is small and lightweight, and it generates less heat than other 
types of voltage converters. 

The voltage converter works by using the DC voltage input to power a 
variable-frequency oscillator. The oscillator drives a small transformer with 
several separate windings to produce the different voltages required. A 
circuit compares the voltage of the +5-volt supply with a reference voltage 
and feeds an error signal back to the oscillator circuit. The oscillator circuit 
uses the error signal to control the duty cycle of its oscillation and keep the 
output voltages in their normal ranges. 


11.2 Power Requirements 
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The converter includes circuitry to protect itself and the other electronic 
parts of the Apple lie by limiting all three output voltages whenever it 
detects one of the following malfunctions: 

□ any supply voltage short-circuited to ground 

□ any output voltage outside the normal range 

Whenever one of these malfunctions occurs, the protection circuit varies 
the duty cycle of the oscillator, and all the output voltages drop to 0 if they 
cannot be brought back into their normal range. 


11.3 Apple lie Overall Block Diagram 


Figure 11-2 is an overall block diagram of the Apple lie. The following 
sections contain more detailed diagrams of the major parts of the machine. 
A full set of schematic diagrams of the Apple lie appears in Section 11.14. 


11.4 The 65C02 Microprocessor 


CMOS (complementary metal-oxide 
semiconductor) is a way of making 
integrated circuits that require less power 
to operate than other technologies such as 
NMOS (negative-doped metal-oxide 
semiconductor), used by the 6502. 


These instructions are described in 
Appendix A. 


The Apple lie uses a CMOS 6502 (designated as 65C02) microprocessor as 
its central processing unit (CPU). The 65C02 in the Apple lie runs at a clock 
rate of 1.023 MHz and performs up to 500,000 8-bit operations per second. 

Note: The clock rate is not a very good criterion for comparing different 
types of microprocessors. The 65C02 has a simpler instruction cycle than 
most other microprocessors and it uses instruction pipelining for faster 
processing. The speed of the 65C02 with a 1-MHz clock is equivalent to 
many other types of microprocessors with clock rates up to 5 MHz. 

In addition to requiring less power than earlier NMOS 6502 processors, the 
65C02 in the Apple lie has 27 new instructions. However, programs that use 
these additional instructions are not backward compatible with other 
Apple II series computers that are not equipped with a CMOS 6502. 


11.4.1 65C02 Block Diagram 

Figure 11-3 is a block diagram of the 65C02 microprocessor. Table 11-5 
contains the general specifications of this chip. The 65C02 has a 16-bit 
address bus, giving it an address space of 64K bytes. The Apple lie uses 
special techniques to address a total of more than 64K (see Chapter 2). 
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Figure 11-2. Apple lie Block Diagram 



11.4 The65C02 Microprocessor 
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Figure 11-3. 65C02 Block Diagram 

Copyright 1982, NCR Corporation. Used by permission of NCR Corporation , Dayton , Ohio. 


Address 

Bus 
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Table 11-5. 65C02 Microprocessor Specifications 


Type: 

65C02 

Register complement: 

8-bit accumulator (A) 

8-bit index registers (X,Y) 
8-bit stack pointer (S) 

8-bit processor status (P) 
16-bit program counter (PC) 

Data bus: 

8 bits wide 

Address bus: 

16 bits wide 

Address range: 

65,536 (64K) 

Interrupts: 

IRQ (maskable) 

NMI (nonmaskable) 

BRK (programmed) 

Operating voltage: 

+5V(±5%) 

Power dissipation: 

5 mW (at 1 MHz) 


11.4.2 65C02 Timing 

The Apple lie’s operation is controlled by a set of synchronous timing 
signals, sometimes called clock signals. The Apple lie uses a 14.318-MHz 
master timing signal, called 14M, to produce all the other timing signals. 
These timing signals perform two major tasks: controlling the computing 
functions, and generating the video display. The timing signals directly 
involved with the 65C02’s operation are described in this section. Other 
timing signals are described in Sections 11.6.2, 11.9.3, and 11.9.4. 

The relationships of the main 65C02 timing signals are diagrammed in 
Figure 11-4, and the signals are listed in Table 11-6. The 65C02 clock signals 
are 4 >\ and 00, complementary signals at a frequency of 1.0227 MHz. The 
Apple lie signal named 4>0 is similar to the signal called $2 in Appendix A 
(it isn’t identical— it’s a tiny bit early). 
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Figure 114. 65C02 Timing Signals 



DATA from 65C02 (write) 


X 


xz 


DATA to 65C02 (read) 


50 ns (min) ~j j-< 

~ xzzxz 


10 ns (min) pA 


Table 11-6. 65C02 Timing Signal Descriptions 

Signal Name Description 

14M Master oscillator, 14.318 MHz; also 80-column dot clock 

VID7M Intermediate timing signal and 40-column dot clock 

Q3 Intermediate timing signal, 2.045 MHz with asymmetrical 

duty cycle 

00 Phase 0 of 65C02 clock, 1.0227 MHz; complement of 01 

01 Phase 1 of 65C02 clock, 1.0227 MHz; complement of 00 
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The 65C02’s operations are related to the clock signals in a simple way: 
internal during 0 1, external during 00. The 65C02 puts an address on the 
address bus during <f> 1. This address is valid not later than 110 nanoseconds 
after 0l goes high and remains valid through all of 00. The 65C02 reads or 
writes data during 00. If the 65C02 is writing, the read/write signal is low 
during 00 and the 65C02 puts data on the data bus. The data are valid not 
later than 75 nanoseconds after 00 goes high. If the 65C02 is reading, the 
read/ write signal remains high. Data on the data bus must be valid no later 
than 50 nanoseconds before the end of 00. 

More information about the 65C02 and its instruction set is in Appendix A. 


11.5 The Custom Integrated Circuits 


Most of the circuitry that controls memory and I/O addressing in the 
Apple lie is in five custom integrated circuits: 

□ the memory management unit (MMU) 

□ the input-output unit (IOU) 

□ the timing generator (TMG) 

□ the general logic unit (GLU) 

□ the disk controller unit, also known as the Integrated Woz Machine 
(IWM) 

The soft switches that control the various I/O and addressing modes of the 
Apple lie are addressable flags inside the MMU, IOU, and GLU. The 
functions of the MMU and IOU are not as independent as their names 
suggest; working together, they generate all the addressing signals. For 
example, the MMU generates the RAM address signals for the CPU, while 
the IOU generates similar RAM address signals for the video display and 
most I/O hardware addresses. 


11.5.1 The Memory Management Unit (MMU) 

The circuitry inside the MMU implements these soft switches: 

□ Page 2 display (Page2) (described in Chapter 5) 

□ high-resolution mode (HiRes) (Chapter 5) 

□ store to 80-column display (80Store) (Chapter 5) 

□ select bank 2 (Bank2) (Chapter 2) 

□ enable bank-switched RAM (EnlCRAM) (Chapter 2) 


11.5 The Custom Integrated Circuits 
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□ read auxiliary memory (RAMRd) (Chapter 2) 

□ write auxiliary memory (RAMWrt) (Chapter 2) 

□ auxiliary stack and zero page (AltZP) (Chapter 2) 

□ reset mouse Y interrupt (RstYInt) (Chapter 9) 
a reset mouse X interrupt (RstXInt) (Chapter 9) 


These switches are available on MMU pin 21, which is connected to bit 7 on 
the data bus. Figure 11-5 shows the MMU pinouts; Table 11-7 describes the 
signals. 


Important! 


A signal name followed by an asterisk is active low— that is, it is true 
when the signal is at a TTL high (+5V) level. 


The 64K dynamic RAMs used in the Apple lie use a multiplexed address, as 
described in Section 11.6.2. The MMU generates this multiplexed address 
for memory reading and writing by the 65C02 CPU. 


Figure 11-5. The MMU Pinouts Table 11-7. The MMU Signal Descriptions 


GND 

i ^ 

40 

A1 

Pin# 

Name 

Description 

AO 

2 

39 

A2 

1 

GND 

Power and signal common 

00 

Q3 

3 

4 

38 

37 

A3 

A4 

2 

AO 

65C02 address input 

PRAS* 

5 

36 

A5 

3 

$0 

Clock phase 0 input 

RAO 

RA1 

RA2 

6 

7 

35 

34 

33 

A6 

A7 

A8 

4 

Q3 

Timing signal input 

1 

8 

5 

PRAS* 

Memory row-address strobe 

RA3 

9 

32 

A9 

6-13 

RA0-RA7 

Multiplexed address output 

RA4 

RA5 

10 

11 

31 

30 

A10 

All 

14 

R/W* 

65C02 read-write control signal 

RA6 

12 

29 

A12 

15 

INH* 

Inhibits main memory (tied to +5V) 

RA7 

R/W* 

INH* 

13 

14 

15 

28 

27 

26 

A13 

A14 

A15 

16 

C06X* 

Causes $C06x outputs to go to 0 during 00 

17 

EN80* 

Enables auxiliary RAM 

C06X* 

16 

25 

+5V 

18 

KBD* 

Enables keyboard data bits 0-6 

EN80* 

KBD* 

17 

18 

24 

23 

SELIO* 

CASEN* 

19 

ROMEN2* 

Enables ROM (tied to ROMEN1*) 

R0MEN2* 

19 

22 

C07X* 

20 

ROMEN1* 

Enables ROM (tied to ROMEN2*) 

ROMENt* 

20 

21 

MD7 

21 

MD7 

State of MMU flags on data bus bit 7 





22 

C07X 

Causes $C07x outputs to go to 0 during 00 





23 

CASEN* 

Enables main RAM 





24 

SELIO* 

Goes to 0 during 00 for any access to SCO page 
except $C08x, Bx, Cx, or Fx 





25 

+5V 

Power 





26-40 

A15-A1 

65C02 address input 
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11.5.2 The Input/Output Unit (IOU) 


Input/output unit (IOU) implements the following soft switches, all 
described in Chapters 2 and 3: 

□ Page 2 display (Page2) 

□ high-resolution mode (HiRes) 

□ text mode (TEXT) 

□ mixed mode (MIXED) 

□ 80-column display (80Col) 

□ character-set select (AltChar) 

□ any-key-down (AKD) 

□ mouse movement (XO, YO) 

□ vertical blanking interrupt (VBlInt) 

These switches are available on IOU pin 9, which is connected to bit 7 on 
the data bus. Figure 11-6 shows the IOU pinouts; Table 11-8 describes the 
signals. 

The 64K dynamic RAMs used in the Apple lie require a multiplexed 
address, as described in Section 11.6.2. The IOU generates this multiplexed 
address during clock phase 1 for the data transfers required for display and 
memory refresh. The way this address is generated is described in 
Section 11.9.1. 


Figure 11-6. The IOU Pinouts 
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10 
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21 


Table 11-8. The IOU Signal Descriptions 


Pin# 

Name 

Description 

1 

GND 

Power and signal common 

2 

GR 

Graphics mode enable 

3 

SEGA 

In text mode, works with VC (see pin 5) and SEGB to 
determine character row address 

4 

SEGB 

In text mode, works with VC (see pin 5) and SEGA; in 
graphics mode, selects high-resolution when low, 
low-resolution when high 

5 

VC 

Displays vertical counter bit: in text mode, SEGA, 
SEGB, and VC determine which of the eight rows of a 
character’s dot pattern to display; in low-resolution, 
selects upper or lower block defined by a byte 
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Table 11-8 — contimued. The IOU Signal Descriptions 


Pin # 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17-24 

25 

26 
27 


30 

31 

32 

33,34 
35, 36 
37 


40 


Name Description 

80COL* 80-column video enable 

CASSO Reserved 

SPKR Speaker output signal 

MD7 Internal IOU flags for data bus (bit 7) 

YMOVE Detects mouse movement along Y axis 

N.C. Not used 

N.C. Not used 

PDLO/XMOVE Detects mouse movement along X axis 

R/W* 65C02 read-write control signal 

RESET* Power on and reset output 

IRQ* Maskable interrupt line to 65C02 

RA0-RA7 Video refresh multiplexed RAM address (phase 1) 

PRAS* Row-address strobe (phase 0) 

00 Master clock phase 0 

Q3 Intermediate timing signal 


+5V Power 

A6 Address bit 6 from 65C02 

IOUSELIO* Derived from the SELIO* output for MMU pin 24 

AKD Any-key-down signal 

KSTRB Keyboard strobe signal 

VIDD7, VIDD6 Video display data bits 

RA9*, RA10* Video display control bits 

CLRGAT* Color-burst gate (enable) 

WNDW* Displays blanking signal 

SYNC* Displays synchronization signal 

HO Displays horizontal timing signal (low bit of character 

counter) 
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11.5.3 The Timing Generator (TMG) 


A custom timing generator chip (TMG) generates several timing and control 
signals in the Apple He. The TMG pinouts are shown in Figure 11-7; the 
signals are listed in Table 11-9. 


Figure 11-7. The TMG Pinouts Table 11-9. The TMG Signal Descriptions 


14M 

7M 

CREF 

HO 

VIDD7 

SEGB 

TEXT 

CASEN* 

80COL* 

GND 


+ 5V 

PRAS* 

(N.C.) 

PC AS* 
Q3 
00 
01 

VID7M 

LDPS* 

TMGEN* 



20 

2 

19 

3 

18 

4 

17 

5 

16 

6 

15 

7 

14 

8 

13 

9 

12 

10 

11 


Pin # 

Name 

Description 

1 

14M 

14.318-MHz master timing signal input 

2 

7M 

7.159-MHz timing signal 

3 

CREF 

3.5795-MHz color reference timing signal 

4 

HO 

Horizontal video timing signal 

5 

VIDD7 

Video data bit 7 

6 

SEGB 

Video timing signal 

7 

TEXT 

Video display text-modes enable 

8 

CASEN* 

RAM enable (CAS enable) 

9 

80COL* 

Enables 80-column display mode 

10 

GND 

Power and signal common 

11 

TMGEN* 

Enables master timing 

12 

LDPS* 

Video shift-register load enable 

13 

VID7M 

Video dot clock enable, 7 MHz or continuous 0 

14 

4> 1 

Phase 1 system clock 

15 

<t> 0 

Phase 0 system clock 

16 

Q3 

Intermediate timing and strobe signal 

17 

PCAS* 

RAM column-address strobe 

18 

N.C. 

Reserved for testing 

19 

PRAS* 

RAM row-address strobe 

20 

+5V 

Power 
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11.5.4 The General Logic Unit (GLU) 


The general logic unit is a single chip that contains the miscellaneous logic 
required for the system. It provides 

□ all RAM read/write timing 

□ double-high-resolution enable/disable 

□ soft-switch status registers 

□ write command registers 

□ IOU control for mouse interrupts 

□ double-high-resolution soft switches. 

The GLU’s pin assignments are shown in Figure 11-8 and its signals are 
listed in Table 11-10. 


Figure 11-8. The GLU Pinouts Table 11-10. The GLU Signal Descriptions 


14M 

1 


+ 5V 

Pin# 

Name 

Description 

AO 

2 

23 

SER* 

1 

14M 

Master clock (14.318 MHz) 

A3 

3 

22 

IOUHOLE 



A4 

4 

21 

DISK* 

2, 3-7 

A0, A3-A7 

Address lines to select least significant byte of 

A5 

5 

20 

7M 



addresses on CO page 

A6 

6 

19 

CREF 



A7 

7 

18 

(N.C.) 

8 

4> 0 

Phase 0 of 1.0227-MHz processor sync clock 

00 

8 

17 

(N.C.) 


SELIO* 


SELIO* 

9 

16 

TEXT 

9 

Device select for selecting most significant byte of the 

GR 

10 

15 

R/W* 



address 

RESET* 

11 

14 

MD7 

10 

GR 


GND 

12 

13 

GLUEN* 

Graphics mode select line 





11 

RESET* 

Master reset for system; resets GLU 





12 

GND 

Ground reference and negative supply 





13 

GLUEN* 

Enables GLU 





14 

MD7 

Indicates status of MMU flags on data bus bit 7 





15 

R/W* 

Read/write qualifier input from processor 





16 

TEXT 

Signal used to generate video timing in 
double-high-resolution or not-graphics 





17, 18 

N.C. 

Not used 





19 

CREF 

Color reference signal 





20 

7M 

7-MHz clock output 





21 

DISK* 

Disk controller device select output 
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Table 11-10— continued. The GLU Signal Descriptions 


Pin # 

Name 

Description 

22 

IOUHOLE 

Controls IOUSELIO 

23 

SER* 

Serial controller device select output 

24 

+5V 

+5 volt supply 

11.5.5 

The Disk 

Controller Unit (IWM) 


For further information on group code The IWM (for Integrated Woz Machine) is a disk controller that includes, on 

recording, refer to Section 11.10. a single chip, all the capabilities of the disk controller card originally 

designed by Steve Wozniak in 1977. 

Right after reset, the IWM is an integrated GCR (group code recording) disk 
drive controller. It also has a status register, mode register, and multiple 
operating modes. It provides both synchronous and asynchronous modes, 
and a fast mode with a data rate twice that of normal disk I/O speeds. 
Figure 11-9 shows the IWM pin assignments; Table 11-11 describes the IWM 
signals. 


Figure 11-9. The IWM Pinouts Table 11-11. The IWM Signal Descriptions 






Pin # 

Name 

SEEKPHO 


28 

SEEKPH1 



SEEKPH2 

2 

27 

SEEKPH3 

1 

SEEKPHO 

AO 

3 

26 

+ 5V 



A1 

4 

25 

Q3 



A2 

5 

24 

7M 

2 

SEEKPH2 

A3 

6 

23 

RESET* 


AO 

DISK* 

7 

22 

RDDATA 

3 

WRDATA 

8 

21 

WRPROT 

4-6 

A1-A3 

WRREQ* 

9 

20 

DR1 * 



DO 

10 

19 

DR2* 



D1 

11 

18 

D7 

7 

DISK* 

D2 

12 

17 

D6 



D3 

13 

16 

D5 



GND 

14 

15 

D4 







8 

WRDATA 


9 

WRREQ* 

10-13 

D0-D3 


Description 

Stepper motor control phase 0, one of four 
programmable disk drive motor phase outputs 

Stepper motor control phase 2 

The data input to the state bit selected by A1 to A3 

These three inputs select one of the eight bits in the 
state register to be updated. 

Device enable. The falling edge of DISK* latches 
information on A1 to A3. The rising edge of either Q3 or 
DISK* qualifies write register data. 

The serial data output. Each 1-bit causes a transition 
on this output. 

This signal is a programmable buffered output line. 

DO to D7 make up the bidirectional data bus. 
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Table_lLJ_l_ — contmued. The IWM Signal Descriptions 


Pin# 

Name 

Description 

14 

GND 

Ground reference and negative supply 

15-18 

D4-D7 

The remaining bits of the bidirectional data bus 

19 

DR2* 

Drive 2 select 

20 

DR1* 

Drive 1 select 

21 

WRPROT 

Write-protect input; this can be polled via bit 7 of the 
status register. 

22 

RDDATA 

Serial data input line. The IWM synchronizes the 
falling transition of each pulse. 

23 

RESET* 

IWM reset: places all IWM outputs in their inactive 
state and sets all state and mode register bits to 0. 

24 

7M 

7-MHz clock input 

25 

Q3 

A 2.0-MHz clock input used to qualify the timing of the 
serial data being written or read 

26 

+5V 

The +5 volt supply 

27 

SEEKPH3 

Stepper motor control phase 3 

28 

SEEKPH1 

Stepper motor control phase 1 

11.6 

Memory 

Addressing 


The 65C02 microprocessor can directly address 65,536 locations. The 
Apple lie uses this entire address space, and then some: some areas in 
memory are used for more than one function. The following sections 
describe the memory devices used in the Apple lie and the way they are 
addressed. Input and output also use portions of the memory address space; 
refer to Chapter 2 for information. 

Figure 11-10 illustrates the Apple He’s overall memory bus organization and 
memory selection signals. 

Note: Some Apple He’s have ROMs with 27xx designations, some 
have 23xx. They are functionally equivalent. 
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Figure IMP. Memory Bus Organization 



11.6.1 ROM Addressing 


In the Apple lie the following programs are permanently stored in a type 
23128 16K-by-8-bit ROM (Figure 11-11): 


□ Applesoft editor and interpreter 

□ Monitor 

□ enhanced video firmware 


UniDisk 3.5 


The version of the Apple lie that supports the UniDisk 3.5 uses a 23256 
32K-by-8-bit ROM. It needs the extra space for the Protocol Converter, 
Mini-Assembler, and other added functions that it supports. 
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Figure 11-11. The 23128 ROM Pinouts 

Note: In the type 23256 ROM, pin # 27 
isA14. 


+ 5V 
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A8 

A9 
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27 
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26 
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24 

6 
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7 

22 

8 

21 

9 

20 

10 

19 

11 

18 

12 
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Figure 11-12. The 2316 ROM Pinouts 



+ 5V 

KA8 

CAPS 

+ 5V 

KBD* 

LANGSW 

GND 

(N.C.) 

D6 

D5 

D4 

D3 


Figure 11-13. The 2364 ROM Pinouts 



+ 5V 
+ 5V 
+ 5V 
A8 
A9 
All 
GND 
AIO 

WNDW* 

07 

06 

05 

04 

03 


The ROM is enabled by two signals called R0MEN1 and R0MEN2. (In the 
Apple lie, R0MEN1 and R0MEN2 are electrically connected.) The segment 
of the ROM enabled by R0MEN1 occupies the memory address space from 
$C100 through $DFFF. The address space from $0300 through $C3FF and 
much of $0800 through $CFFF contains the enhanced video firmware. 

These ROM address allocations are approximately true (some space sharing 
takes place): 

□ ROM addresses $C000 through $COFF are never available. 

□ ROM addresses $C100 and $0200 are entry points to firmware for serial 
ports 1 and 2, respectively. 

□ ROM address $0400 is the entry point to mouse interface support. 

□ ROM addresses $0500 through $C5FF are reserved. 

□ ROM address $0600 is the entry point to firmware for the built-in and 
external disk drives. The built-in drive is considered slot 6 drive 1 or its 
equivalent. The external drive is considered slot 6 drive 2. 

□ ROM addresses starting at $0700 support (from the Monitor) the external 
drive as if it were slot 7 drive 1, for external-drive startup only. 

□ Addresses $D000 through $F7FF contain the Applesoft BASIC 
interpreter; addresses $F800 through $FFFF contain the Monitor 
firmware. 

The other ROMs in the Apple lie are a type 2316 ROM (Figure 11-12) used 
for the keyboard character decoder, and a type 2364 ROM (Figure 11-13) 
used for character sets for the video display. This 2364 ROM is rather large 
because it includes a section of straight-through bit-mapping for the 
graphics modes. This way, graphics display video can pass through the 
same circuits as text without additional switching circuitry. 


11.6.2 RAM Addressing 

The RAM (programmable) memory in the Apple lie is used both for program 
and data storage and for the video display. The areas in RAM that are used 
for the display are accessed both by the 65C02 microprocessor and by the 
video display circuits. In some computers, this dual access results in 
addressing conflicts (cycle stealing) that can cause temporary dropouts in 
the video display. This problem does not occur in the Apple lie, thanks to 
the way the microprocessor and the video circuits share the memory. 
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The memory circuits in the Apple lie take advantage of the two-phase 
system clock described in Section 11.4.2 to interleave the microprocessor 
memory accesses and the display memory accesses so that they never 
interfere with each other. The microprocessor reads or writes to RAM only 
during $0, and the display circuits read data only during <pl. 


Figure 11-14. The 64K RAM Pinouts 
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Dynamic RAM Refreshment 

The image on a video display is not permanent; it fades rapidly and must be 
refreshed periodically. To refresh the video display, the Apple lie reads the 
data in the active display page and sends them to the display. To prevent 
visible flicker in the display, and to conform to standard practice for 
broadcast video, the Apple lie refreshes the display 60 times per second. 

The dynamic RAM devices used in the Apple lie also need a kind of 
refreshment, because the data are stored in the form of electric charges that 
diminish with time and must be replenished. The Apple lie is designed so 
that refreshing the display also refreshes the dynamic RAMs. The next few 
paragraphs explain how this is done. 

The job of refreshing the dynamic RAM devices is minimized by the 
structure of the devices themselves. The individual data cells in each RAM 
device are arranged in a rectangular array of rows and columns. When the 
device is addressed, the part of the address that specifies a row is presented 
first, followed by the address of the column. Splitting information into parts 
that follow each other in time is called multiplexing. Since only half of the 
address is needed at one time, multiplexing the address reduces the number 
of pins needed for connecting the RAMs (Figure 11-14). 

Different manufacturers’ 64K RAMs have cell arrays of either 128 rows by 
512 columns or 256 rows by 256 columns. Only the row portion of the 
address is used in refreshing the RAMs. 

Now consider how the display is refreshed. As described in Section 11.9.1, 
the display circuitry generates a sequence of 8,192 memory addresses in 
high-resolution mode; in text and low-resolution modes, this sequence is the 
1,024 display-page addresses repeated 8 times. The display address cycles 
through this sequence 60 times a second, or once every 17 milliseconds. The 
way the low-order address lines are assigned to the RAMs, the row address 
cycles through all 256 possible values once every 2 milliseconds (see 
Table 11-12). This more than satisfies the refresh requirements of the 
dynamic RAMs. 
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Table 11-12. RAM Address Multiplexing 


Mux’d 

Row 

Column 

Address 

Address 

Address 

RAO 

AO 

A9 

RA1 

A1 

A6 

RA2 

A2 

A10 

RA3 

A3 

All 

RA4 

A4 

A12 

RA5 

A5 

A13 

RA6 

A7 

A14 

RA7 

A8 

A15 


Dynamic RAM Timing 

The Apple He’s microprocessor clock runs at a speed of 1.023 MHz, but the 
interleaving of CPU and display cycles means that the RAM is being 
accessed at a 2-MHz rate, or a cycle time of just under 500 nanoseconds. 
Data for the CPU are strobed by the falling edge of 0, and display data are 
strobed by the falling edge of <t> 1, as shown in Figure 11-15. 

The RAM timing looks complicated because the RAM address is 
multiplexed, as described in the previous section. The MMU takes care of 
multiplexing the address for the CPU cycle, and the IOU performs the same 
function for the display cycle. The multiplexed address is sent to the 
RAM ICs over the lines labeled RA0-RA7 (Table 11-13). Along with the 
other timing signals, the TMG generates two signals that control the RAM 
addressing: row-address strobe (RAS) and column-address strobe (CAS). 


Table 11-13. RAM Timing Signals 


Signal 

Name 

Description 

00 

Clock phase 0 (CPU phase) 

01 

Clock phase 1 (display phase) 

RAS 

Row-address strobe 

CAS 

Column-address strobe 

Q3 

Alternate RAM/column-address strobe 

RA0-RA7 

Multiplexed address bus 

MD0-MD7 

Internal data bus 
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Figure 11-15. RAM Timing Signals 
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11.7 The Keyboard 


The Apple lie’s keyboard is a matrix of keyswitches connected to an 
AY-3600-type keyboard decoder via a ribbon cable and a 26-pin connector 
(Figure 11-16). The AY-3600 scans the array of keys over and over to detect 
any keys pressed. The scanning rate is set by the external resistor-capacitor 
network made up of C46 and R6. The debounce time is also set externally, 
by C45. 
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Figure 11-16. Keyboard Circuit Diagram 



238 


Chapter 11: Hardware Implementation 


The AY-3600’s outputs include five bits of key code plus separate lines for 
CONTROL, SHIFT, any-key-down, and keyboard strobe. The any-key-down 
and keyboard-strobe lines are connected to the IOU, which addresses them 
as soft switches. The key-code line and CONTROL and SHIFT are inputs to 
a separate 2316 ROM. The ROM translates them to the character codes that 
are enabled onto the data bus by signals named KBD* and ENKBD*. The 
KBD* signal is enabled by the MMU whenever a program reads 
location $C000, as described in Chapter 2. 

Figure 11-17 illustrates the events that occur when a key is pressed, when 
the keypress is detected by a program, and when a key is pressed and held 
for more than about a second. 


Figure 11-17. Keyboard Signals 
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AUD is an audio-amplifier hybrid circuit. 


11.8 The Speaker 


The Apple He’s built-in loudspeaker is controlled by a single bit of output 
from the input/output unit (IOU), amplified by a hybrid circuit 
(Figure 11-18). 


Figure U-18. Speaker Circuit Diagram 



11.8.1 Volume Control 


There is a 500-ohm variable resistor feeding anywhere from 0 to 5 volts to 
pin 5 of AUD to control the speaker volume. This potentiometer controls the 
volume of both the built-in speaker and whatever is plugged into the output 
jack. 


11.8.2 Output Jack 

Next to the volume control, along the lower-left side of the Apple lie case, 
there is a 3.5-mm audio output jack. Although speaker output is monaural, 
the jack accommodates stereo headphone plugs (as well as monaural), 
providing sound to both channels. Inserting a headphone plug into the jack 
disconnects the built-in speaker. 
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11.9 The Video Display 


The Apple lie produces a video signal that creates a display on a standard 
video monitor or, if you add an RF modulator, on a black-and-white or color 
television set. The video signal is a composite made up of the data that are 
being displayed plus the horizontal and vertical synchronization signals that 
the video monitor uses to arrange the lines of display data on the screen. 

Note: Apple lie computers manufactured for sale in the USA generate a 
video signal that is compatible with the standards set by the NTSC 
(National Television Standards Committee). Apple He’s used in European 
countries require an external adapter to provide video that is compatible 
with the standard used there, which is called PAL (for phase alternating 
lines). References to the PAL standard are found in the bibliography at 
the end of this manual. This manual describes only the NTSC version of 
the video circuits. 

The display portion of the video signal is a time-varying voltage generated 
from a stream of data bits, where a 1 corresponds to a voltage that generates 
a bright dot, and a 0 to a dark dot. The display bit stream is generated in 
bursts that correspond to the horizontal lines of dots on the video screen. 
The signal named WNDW* is low during these bursts. 

During the time intervals between bursts of data, nothing is displayed on 
the screen. During these intervals, called the blanking intervals, the display 
is blank and the WNDW* signal is high. The synchronization signals, called 
sync for short, are produced by making the signal named SYNC* low during 
portions of the blanking intervals. The sync pulses are at a voltage 
equivalent to blacker-than-black video and don’t show on the screen. 


11.9.1 The Video Counters 


The address and timing signals that control the generation of the video 
display are all derived from a chain of counters inside the IOU. Only a few 
of these counter signals are accessible from outside the IOU, but they are all 
important in understanding the operation of the display generation process, 
particularly the display memory addressing described in the next section. 

The horizontal counter is made up of seven stages: HO, HI, H2, H3, H4, H5, 
and HPE*. The input to the horizontal counter is the 1-MHz signal that 
controls the reading of data being displayed. The complete cycle of the 
horizontal counter consists of 65 states. The six bits HO through H5 count 
from 0 to 64, then start over at 0. Whenever this happens, HPE* forces 
another count with HO through H5 held at 0, extending the total count to 65. 
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The IOU uses the 40 horizontal count values from 25 through 64 in 
generating the low-order part of the display data address, as described in 
Section 11.9.3. The IOU uses the count values from 0 to 24 to generate the 
horizontal blanking, the horizontal sync pulse, and the color-burst gate. 

When the horizontal count gets to 65, it signals the end of a line by 
triggering the vertical counter. The vertical counter has nine stages: 

VA, VB, VC, VO, VI, V2, V3, V4, and V5. When the vertical count 
reaches 262, the IOU resets it and starts counting again from 0. Only the 
first 192 scanning lines are actually displayed; the IOU uses the vertical 
counts from 192 to 262 to generate the vertical blanking and sync pulse. 
Nothing is displayed during the vertical blanking interval. (The vertical line 
count is 262 rather than the standard 262.5 because, unlike normal 
television, the Apple He’s video display is not interlaced.) 


11.9.2 Display Memory Addressing 

As described in Section 5.7, data bytes are not stored in memory in the same 
sequence in which they appear on the display. You can get an idea of the 
way the display data are stored by using the Monitor to set the display to 
graphics mode, then storing data starting at the beginning of the display 
page at hexadecimal $0400 and watching the effect on the display. If you do 
this, you should use the graphics display instead of text to avoid confusion: 
the text display is also used for Monitor input and output. 

If you want your program to display data by storing them directly into the 
display memory, you must first transform the display coordinates into the 
appropriate memory addresses, as shown in Chapter 2. The descriptions 
that follow will help you understand how this address transformation is 
done and why it is necessary. 

The address transformation that folds three rows of 40 display bytes into 
128 contiguous memory locations is the same for all display modes, so it is 
described first. The differences among the different display modes are 
described in Section 11.9.4. 


11.9.3 Display Address Mapping 

Consider the simplest display on the Apple lie, the 40-column text mode. To 
address 40 columns requires 6 bits, and to address 24 rows requires another 
5 bits, for a total of 11 address bits. Addressing the display this way would 
involve 2048 (2 to the 11th power) bytes of memory to display a mere 
960 characters. The 80-column text mode would require 4096 bytes to 
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The requirements for RAM refreshing are 
discussed in Section 11.6.2. 


display 1920 characters. The leftover chunks of memory that were not 
displayed could be used for storing other data, but not easily, because they 
would not be contiguous. 

Instead of using the horizontal and vertical counts to address memory 
directly, the circuitry inside the IOU transforms them into the new address 
signals described below. The transformed display address must meet the 
following criteria: 

□ map the 960 bytes of 40-column text into only 1024 bytes 

□ scan the low-order address to refresh the dynamic RAMs 

□ continue to refresh the RAMs during video blanking 

The transformation involves only horizontal counts H3, H4, and H5, and 
vertical counts V3 and V4. Vertical count bits VA, VB, and VC address the 
lines making up the characters, and are not involved in the address 
transformation. The remaining low-order count bits, HO, HI, H2, VO, VI, 
and V2 are used directly, and are not involved in the transformation. 

The IOU performs an addition that reduces the five significant count bits to 
four new signals called SO, SI, S2, and S3, where S stands for sum. 

Figure 11-19 is a diagram showing the addition in binary form, with 
V3 appearing as the carry in and H5 appearing as its complement H5*. A 
constant value of 1 appears as the low-order bit of the addend. The carry bit 
generated with the sum is not used. 

If this transformation seems terribly obscure, try it with actual values. For 
example, for the upper-left corner of the display, the vertical count is 0 and 
the horizontal count is 24: HO, HI, H2, and H5 are Os, and H3 and H4 are Is. 
The value of the sum is 0, so the memory location for the first character on 
the display is the first location in the display page, as you might expect. 


Figure 1F19. Display Address Transformation 

V3 Carry in 
H5* V3 H4 H3 Augend 

V4 H5* V4 1 Addend 

S3 S2 SI SO Sum 
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Horizontal bits HO, HI, and H2 and sum bits SO, SI, and S2 make up the 
transformed horizontal address (AO through A6 in Table 11-14). As the 
horizontal count increases from 24 to 63, the value of the sum (S3 S2 SI SO) 
increases from 0 to 4 and the transformed address goes from 0 to 39, relative 
to the beginning of the display page. 

The low-order three bits of the vertical row counter are VO, VI, and V2. 
These bits control address bits A7, A8, and A9, as shown in Table 11-14, so 
that rows 0 through 7 start on 128-byte boundaries. When the vertical row 
counter reaches 8, VO, VI, and V2 are 0 again, and V3 changes to 1. If you do 
the addition in Figure 11-19 with H equal to 24 (the horizontal count for the 
first column displayed) and V equal to 8, the sum is 5 and the horizontal 
address is 40: the first character in row 8 is stored in the memory location 
40 bytes from the beginning of the display page. 

Table 11-14 shows how the signals from the video counters are assigned to 
the address lines. HO, HI, and H2 are horizontal-count bits, and VO, VI, 
and V2 are vertical-count bits. SO, SI, S2, and S3 are the folded address bits 
described above. Table 11-15 shows memory address bits for the display 
modes. 


Table 77-/4. Display Memory Addressing 


Memory 
Address Bit 

AO 

A1 

A2 

A3 

A4 

A5 

A6 

A7 

A8 

A9 

A10 

All 

A12 

A13 

A14 

A15 


Display 
Address Bit 

HO 

HI 

H2 

50 

51 

52 

53 
VO 
VI 
V2 


GND 


* For these address bits, see Table 11-15. 
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Table 11-15. Memory Address Bits for Display Modes 
Note: . means logical AND; ’ means logical NOT. 


Display Modes 


Address Bit 

Text and 

Low-Resolution 

High-Resolution and 
Double-High-Resolution 

A10 

80STORE+PAGE2’ 

VA 

All 

80STORE’.PAGE2 

VB 

A12 

0 

VC 

A13 

0 

80STORE+PAGE2’ 

A14 

0 

80STORE’.PAGE2 


Figure 11-20 shows how groups of three 40-character rows are stored in 
blocks of 120 contiguous bytes starting on 128-byte address boundaries. 
This diagram is another way of describing the display mapping shown in 
Figure 5-5. Notice that the three rows in each block of 120 bytes are not 
adjacent on the display. 


Figure 11-20. 40-Column Text Display Memory 

Note: Memory locations marked with a double asterisk (**) are screen holes, 
described in Section 2.5.1. 
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(From Fig. 11-15) 


11.9.4 Video Display Modes 


The different display modes all use the address-mapping scheme described 
in Section 11.9.3, but they use different-sized memory areas in different 
locations. This section describes the addressing schemes and the methods 
of generating the actual video signals for the different display modes. 
Figure 11-21 illustrates the video display circuits discussed in this section. 


Figure 1F2L Video Display Circuits 
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Text Displays 


The text and low-resolution graphics pages begin at memory locations 
$0400 and $0800. Table 11-15 shows how the display-mode signals control 
the address bits to produce these addresses. Address bits A10 and All are 
controlled by the settings of Page2 and 80Store, the display-page and 
80-column-video soft switches. Address bits A12, A13, and A14 are set to 0. 
Notice that 80Store active inhibits Page2: there is only one display page in 
80-column mode. 

The low-order six bits of each data byte reach the character generator 
directly, via the video data bus VID0-VID5. The two high-order bits are 
modified by the IOU to select between the primary and alternate character 
sets and are sent to the character generator on lines RA9 and RA10. 

The data for each row of characters are read eight times, once for each of 
the eight lines of dots making up the row of characters. The data bits are 
sent to the character generator along with VA, VB, and VC, the low-order 
bits from the vertical counter. For each character being displayed, the 
character generator puts out one of eight stored bit patterns selected by the 
three-bit number made up of VA, VB, and VC. 

The bit patterns from the character generator are loaded into the 74166 
parallel-to-serial shift register and output as a serial bit stream that goes to 
the video output circuit (Figure 11-21). The shift register is controlled by 
signals named LDPS* (for load parallel-to-serial shifter) and VID7M (for 
video 7 MHz). In 40-column mode, LDPS* strobes the output of the character 
generator into the shift register once each microsecond, and VID7M shifts 
the bits out at 7 MHz (Figure 11-22). 

The addressing for the 80-column display is exactly the same as for the 
40-column display: the 40 columns of display memory in auxiliary memory 
are addressed in parallel with the 40 columns in main memory. The data 
from these two memories reach the video data bus (lines VID0-VID7) via 
separate 74LS374 three-state buffers. These buffers are loaded 
simultaneously (at the rising edge of 4> 0), but their outputs are sent to the 
character generator alternately by the falling edge of </>0 and <j>l. In 
80-column mode, LDPS* loads data from the character generator into the 
shift register twice during each microsecond, once during <p0 and once 
during <t> 1, and VID7M remains low, enabling the clock continuously at 14M 
(Figure 11-23). 
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Figure 11-22. 7-MHz Video Timing Signals (40-Column, Low-Resolution, and High-Resolution Display) 


14M 

7M 

00 


01 


P CPU Phase ^ j 


Video Phase 


v 

DATA BUS XZZZX 


VIDEO LATCH 

LDPS* AND EN80* 

VIDEO BUS into CHARGEN 


I 


V 


x= z~ X 





r 1 

u 


x~ X 


OUTPUT BUS into SPI (Shift Register) 


I 

X 


X 


SPI Serial Output (VID7M and 14M) 



248 


Chapter 11: Hardware Implementation 


Figure 11-23. 14-MHz Video Timing Signals (80-Column and Double-High-Resolution Display) 


14M 





DATA BUS X~ D o X 

' I 

VIDEO LATCH X 

I 

ALTERNATE BUs X~ ALT o X 

1 

80 LATCH 

LDPS* 

(EN80* always on) 

VIDEO BUS into CHARGEN 




y 

1 1 

r y 

J 1 

o 

Q 

X 

X ALT o 

XS 


U 


OUTPUT BUS into SPI (Shift Register) 

SPI Serial Output (14M Clock) 


x: 


H 


x: 


ALTn 


jiniiimnRTUirinruTJTJiiiJ 


v v jr v 


11.9 The Video Display 


249 


Low-Resolution Display 


In the graphics modes, VA and VB are not used by the character generator, 
so the IOU uses lines SEGA and SEGB to transmit HO and HIRES*, as shown 
in Table 11-16. 


Table 11 - 16 . Character-Generator Control Signals 


Display Mode 

SEGA 

SEGB 

SEGC 

Text 

VA 

VB 

VC 

Graphics 

HO 

HIRES* 

VC 


The low-resolution graphics display uses VC to divide the eight display lines 
corresponding to a row of characters into two groups of four lines each. 

Each row of data bytes is addressed eight times, the same as in text mode, 
but each byte is interpreted as two nibbles. Each nibble selects 1 of 16 
colors. During the upper four of the eight display lines, VC is low and the 
low-order nibble determines the color. During the lower four display lines, 
VC is high and the high-order nibble determines the color. 

The bit patterns that produce the low-resolution colors are read from the 
character-generator ROM in the same way the bit patterns for characters 
are produced in text mode. The 74166 parallel-to-serial shift register 
converts the bit patterns to a serial bit stream for the video circuits 
(Figure 11-21). 

The video signal generated by the Apple lie includes a short burst of 
3.58-MHz signal that is used by an NTSC color monitor or color TV set to 
generate a reference 3.58-MHz color signal. The Apple He’s video signal 
produces color by interacting with this 3.58-MHz signal inside the monitor or 
TV set. Different bit patterns produce different colors by changing the duty 
cycles and delays of the bit stream relative to the 3.58-MHz color signal. To 
produce the small delays required for so many different colors, the shift 
register runs at 14 MHz and shifts out 14 bits during each cycle of the 1-MHz 
data clock. To generate a stream of 14 bits from each 8-bit pattern read from 
the ROM, the output of the shift register is connected back to the register’s 
serial input to repeat the same 8 bits; the last 2 bits are ignored the second 
time around. 

Each bit pattern is output for the same amount of time as a character: 

1.02 microseconds. Because that is exactly enough time for three and a half 
cycles of the 3.58-MHz color signal, the phase relationship between the bit 
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patterns and the signal changes by a half cycle for each successive pattern. 
To compensate for this, the character generator puts out one of two 
different bit patterns for each nibble, depending on the state of HO, the 
low-order bit of the horizontal counter. 

High-Resolution Display 

The high-resolution graphics pages begin at memory locations $2000 and 
$4000 (decimal 8192 and 16384). These page addresses are selected by 
address bits A13 and A14. In high-resolution mode, these address bits are 
controlled by PAGE2 and 80STORE, the signals controlled by the 
display-page (Page2) and 80-column-video (80Col) soft switches. As in text 
mode, 80STORE inhibits addressing of the second page because there is 
only one page of 80-column text available for mixed mode. 

In high-resolution graphics mode, the display data are still stored in blocks 
like the one shown in Figure 11-20, but there are eight of these blocks. As 
Tables 11-14 and 11-15 show, vertical counts VA, VB, and VC are used for 
address bits A10, All, and A12, which address eight blocks of 1024 bytes 
each. Remember that in the display, VA, VB, and VC count adjacent 
horizontal lines in groups of eight. This addressing scheme maps each of 
those lines into a different 1024-byte block. 

It might help to think of this scheme as a kind of eight-way multiplexer: it’s 
as if eight text displays were combined to produce a single high-resolution 
display, with each text display providing one line of dots in turn, instead of 
a row of characters. 

The high-resolution bit patterns are produced by the character-generator 
ROM. In this mode, the bit patterns simply reproduce the seven bits of 
display data. The low-order six bits of data reach the ROM via the video 
data bus VID0-VID5. The IOU sends the other two data bits to the ROM via 
RA9 and RA10. 

The high-resolution colors described in Chapter 2 are produced by the 
interaction between the video signal the bit patterns generate and the 
3.58-MHz color signal generated inside the monitor or TV set. The 
high-resolution bit patterns are always shifted out at 7 MHz, so each dot 
corresponds to a half-cycle of the 3.58-MHz color signal. Any part of the 
video signal that produces a single white dot between two black dots, or 
vice versa, is effectively a short burst of 3.58 MHz and is therefore displayed 
as color. In other words, a bit pattern consisting of alternating Is and 0s gets 
displayed as a line of color. The high-resolution graphics subroutines 
produce the appropriate bit patterns by masking the data bits with 
alternating Is and 0s. 
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To produce different colors, the bit patterns must have different phase 
relationships to the 3.58-MHz color signal. If alternating Is and Os produce a 
certain color, say green, then reversing the pattern to Os and Is will produce 
the complementary color, purple. As in the low-resolution mode, each bit 
pattern corresponds to three and a half cycles of the color signal, so the 
phase relationship between the data bits and the color signal changes by a 
half cycle for each successive byte of data. Here, however, the bit patterns 
produced by the hardware are the same for adjacent bytes; the color 
compensation is performed by the high-resolution software, which uses 
different color masks for data being displayed in even and odd columns. 

To produce other colors, bit patterns must have other timing relationships 
to the 3.58-MHz color signal. In high-resolution mode, the Apple lie produces 
two more colors by delaying the output of the shift register by half a dot 
(70 ns), depending on the high-order bit of the data byte being displayed. 
(The high-order bit doesn’t actually get displayed as a dot, because at 7 MHz 
there is only time to shift out seven of the eight bits.) 

As each byte of data is sent from the character generator to the shift 
register, high-order data bit D7 is also sent to the TMG. If D7 is off, the TMG 
transmits shift-register timing signals LDPS* and VID7M normally. If D7 is 
on, the TMG delays LDPS* and VID7M by 70 nanoseconds, the time 
corresponding to half a dot. The bit pattern that formerly produced green 
now produces orange; the pattern for purple now produces blue. 

A Note About Timing: For 80-column text, the shift register is clocked 
at twice normal speed. When 80-column text is used with graphics in 
mixed mode, the TMG controls shift-register timing signals LDPS* and 
VID7M so that the graphics portion of the display works correctly even 
when the text window is in 80-column mode. 

Double-High-Resolution Display 

Double-high-resolution graphics mode displays two bytes in the time 
normally required for one, but it uses high-resolution graphics Pages 1 
and IX instead of text and low-resolution Pages 1 and IX. 

Note: There is a second pair, HRP2 and HRP2X, which can be used to 
display a second double-high-resolution page. 

Double-high-resolution graphics mode displays each pair of data bytes as 
14 adjacent dots, 7 from each byte. The high-order bit (color-select bit) of 
each byte is ignored. The auxiliary-memory byte is displayed first, so data 
from auxiliary memory appear in columns 0-6, 14-20, and so on, up to 
columns 647-552. Data from main memory appear in columns 7-13, 21-27, 
and so on, up to 553-559. 
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RGB stands for red, green, and blue, and 
identifies a type of color monitor that uses 
independent inputs for the three primary 
colors. 


For further information about 
double-high-resolution graphics display, 
refer to the Bibliography. 


VID is a video-amplifier hybrid circuit. 


As in 80-column text, there are twice as many dots across the display 
screen, so the dots are only half as wide. On a TV set or low-bandwidth (less 
than 14 MHz) monitor, single dots are dimmer than normal. 

Note: Except for some expensive RGB-type color monitors, any video 
monitor with a bandwidth as high as 14 MHz will be a monochrome 
monitor. Monochrome means one color: a monochrome video monitor can 
have a screen color of white, green, orange, or any other single color. 

The main memory and auxiliary memory are connected to the address bus 
in parallel, so both are activated during the display cycle. The rising edge 
of (j > 0 clocks a byte of main memory data into the video latch, and a byte of 
auxiliary memory data into the 80 latch (Figure 11-21). 

Phi 1 enables output from the (auxiliary) 80 latch, and <p0 enables output 
from the (main) video latch. Output from both latches goes to CHARGEN, 
where GR and SEGB* select high-resolution graphics. LDPS operates at 
2 MHz in this mode, alternately gating the auxiliary byte and main byte into 
the parallel-to-serial shift register. VID7M is active (kept true) for 
double-high-resolution display mode, so when it is ANDed with 14M, the 
result is still 14M. The 14M serial clock signal gates shift register output to 
VID, the video display hybrid circuit, for output to the display device. 


11.9.5 Video Output Signals 

The stream of video data generated by the display circuits described above 
goes to a hybrid circuit (VID) that adjusts the signals to the proper 
amplitudes and conditions the color burst. 

The resulting video signal is an NTSC-compatible composite-video signal 
that can be displayed on a standard video monitor. The signal is similar to 
the EIA (Electronic Industries Association) standard positive composite 
video. This signal is available in two places in the Apple lie (Figure 11-24): 

□ at the video output connector on the back of the Apple lie 

□ at the video expansion connector (pin 12) on the back panel 
(Table 11-17) 

Monitor Output 

The sleeve of the video output connector at the center of the Apple lie back 
panel is connected to ground and the tip is connected to the video output 
through a resistor network that attenuates it to about 1 volt and matches its 
impedance to 75 ohms. This arrangement is suitable for most video 
monitors. 
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Expansion Connector (For a Monitor) 
(For an RF Modulator 
or Special Adaptor) 

(See Fig. 11-25) 


Video Expansion Output 

The back panel of the Apple lie has a DB-15 connector for sophisticated 
video interfaces external to the computer. Figure 11-25 shows the pin 
assignments for this connector; Table 11-17 describes the signals. In Table 
11-17, the column labeled Deriv indicates what clock signals the video 
signals are derived from. LDPS, CREF, and PRAS have a maximum delay of 
30 ns from the appropriate 14-MHz rising edge. SEROUT is clocked out of a 
74LS166 by the rising edge of 14M and has a maximum delay of 35 ns. 
VIDD7 is driven from a 74LS374 and has a maximum delay of 28 ns from 
the rising and (if 80-column) falling edges of 4>l. 

To align CREF so it is in the same phase at the beginning of every line, 
certain clock signals must be stretched. This stretch is for one 7M cycle 
(140 ns), and occurs at the end of each video line. All timing signals except 
14M, 7M, and CREF are stretched. 


▲Warning 


The maximum allowable current drain of + 12V regulated power at the 
video expansion connector is 300 milliamps. If the external device draws 
more than this, it can damage the computer or cause the power supply to 
shut down. 
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▲Warning 


The signals at the DB-15 on the Apple lie are not the same as those at the 
DB-15 on the Apple III. Do not attempt to plug a cable intended for one 
into the other. 

Several of these signals, such as 14 MHz, must be buffered within about 
four inches (10 cm) of the back panel connector— preferably inside a 
container directly connected to the back panel. For technical information, 
contact Apple Technical Support. 


Figure 11-25. The Video Expansion Connector Pinouts 
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Pin 

Signal 

Pin 

Signal 

1 

TEXT 

9 

PRAS* 

2 

14M 

10 

GR 

3 

SYNC* 

11 

SEROUT’ 

4 

SEGB 

12 

NTSC 

5 

1VS0UND 

13 

GND 

6 

LDPS* 

14 

V1DD7 

7 

WNDW* 

15 

CREF 

8 

+12V 




Table 11-17. The Video Expansion Connector Signals 


Pin # 

Deriv 

Name 

Description 

1 

00 

TEXT 

Video text signal from TMG; set to inverse of 
GR, except in double-high-resolution mode 

2 


14M 

14-MHz master timing signal from the system 
oscillator 

3 

Q3 

SYNC* 

Displays horizontal and vertical 
synchronization signal from IOU pin 39 

4 

PRAS 

SEGB 

Displays vertical counter bit from IOU pin 4; 
in text mode indicates second low-order 
vertical counter; in graphics mode indicates 
low-resolution 
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Table 11-1 7 — continued. The Video Expansion Connector Signals 


Pin# 

Deriv 

Name 

Description 

5 


1VSOUND 

One-volt sound signal from pin 5 of the audio 
hybrid circuit (AUD) 

6 

14M 

LDPS* 

Video shift-register load enable from pin 12 o: 
TMG 

7 

PRAS 

WNDW* 

Active area display blanking; includes both 
horizontal and vertical blanking 

8 


+12V 

Regulated +12 volts DC; can drive 300 mA 

9 

14M 

PRAS* 

RAM row-address strobe from TMG pin 19 

10 

PRAS 

GR 

Graphics mode enable from IOU pin 2 

11 

14M 

SEROUT* 

Serialized character-generator output from 
pin 1 of the 74LS166 shift register 

12 


NTSC 

Composite NTSC video signal from VID 
hybrid chip 

13 


GND 

Ground reference and supply 

14 

00 

VIDD7 

From 74LS374 video latch; causes half-dot 
shift if high 

15 

14M 

CREF 

Color reference signal from TMG pin 3; 

3.58 MHz 


11.10 Disk I/O 


Disk I/O— for both the built-in and the external drive— is supported by the 
IWM disk controller unit. The external drive is attached via a DB-19 
connector. Figure 11-26 shows this connector. Table 11-18 describes the pin 
assignments. Supply voltages come from the power supply; all other signals 
come from the IWM, described in Section 11.5.5. 


AWarning 


The power available at this connector is for a Disk lie or similar drive 
only. Do not use power from the external disk connector for any other 
purpose— you may damage the internal voltage converter. To derive 
external power for an attached device, use one of the other connectors 
and observe the current limits given in this manual. 
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Figure 11-26. Disk Drive Connector 
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Pin 

Signal 

Pin 

Signal 

1,2,3, 4 

GND 

13 

SEEKPH2 

5 

-12V 

14 

SEEKPH3 

6 

+5V 

15 

WRREQ* 

7,8 

+12V 

16 

N.C. 

9 

EXTINT* 

17 

DR2* 

10 

WRPROT 

18 

RDDATA 

11 

SEEKPHO 

19 

WRDATA 

12 

SEEKPH1 




Table 11-18. Disk Drive Connector Signals 


Connector 
Pin # 

Name 

Description 

1, 2, 3, 4 

GND 

Ground reference and supply 

6 

+5V 

+5 volt supply 

7,8 

+12 

+12 volt supply 

9 

EXTINT* 

External interrupt 

10 

WRPROT 

Write-protect input 

11-14 

</>0-4 

Motor phase 0-4 output 

15 

WRREQ* 

Write request 

17 

DR1* 

Drive 1 select 

18 

RDDATA 

Read data input 

19 

WRDATA 

Write data output 

11.11 

Serial I/O 



The Apple lie has built into it two 6551 asynchronous communication 
interface adapters (ACIA) and supporting input and output buffers for 
full-duplex serial communication. Figure 11-27 is a block diagram of the 
Apple lie serial ports. ACIA outputs are buffered by a 1448-quad line driver. 
Similarly, ACIA inputs are buffered by a 1489-quad line receiver. 


11.11 Serial 1/0 
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Address Bus 


Figure 11-27. Serial Port Circuits 
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Port 1 Port 2 


Figure 11-28 is a detailed block diagram of the 6551 ACIA. The registers are described in Sections 11.11.1 
through 11.11.4. 


Figure 11-28. 6551 ACIA Block Diagram 

Copyright 1978, Synertek Inc. Used by permission of Synertek Inc., 3001 Stender, Santa Clara, CA 95052. 
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The 6551 pin assignments are shown in Figure 11-29 and described in 
Table 11-19. Note that the two 6551s are not used in exactly the same 
way — each one supports a different set of interrupts. 

Port 1 reads external interrupts (EXTINT*) on its Data Set Ready (DSR) 
pin. This input is tied to +5V through a 3.3-KC2 pullup resistor. 
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Figure 11-29. The 6551 Pinouts Table 11-19. The 6551 Signal Descriptions 


GND 

i ^ 

28 

R/W* 

Pin# 

Name 

Description 

A5 

2 

27 

00 

1 

GND 

Power and signal common ground 

SER* 

3 

26 

IRQ* 



RESET* 

4 

25 

D7 

2 

A4 

Address line 4 to select serial port 1 

(N.C.) 

5 

24 

D6 


A5 

Address line 5 to select serial port 2 

BCLK 

6 

23 

D5 



(N.C.) 

7 

22 

D4 

3 

SER* 

Serial device select from GLU 

RTS* 

8 

21 

D3 




CTS* 

9 

20 

D2 

4 

RESET* 

Resets both serial ports 

TxD 

(N.C.) 

10 

11 

19 

18 

D1 

DO 

5 

N.C. 

Not connected 

RxD 

12 

17 

DSR* 

6 

BCLK 

Baud rate clock from GLU 

AO 

13 

16 

DCD* 



A1 

14 

15 

+ 5V 

7 

N.C. 

Not connected 





8 

RTS* 

Request to Send output 





9 

CTS* 

Clear to Send input (not used on lie; tied to ground) 





10 

TXD 

Transmit Data output 





11 

N.C. 

Not connected 





12 

RXD 

Receive Data input 





13, 14 

AO, A1 

Address lines 0 and 1 





15 

+5V 

+5 volt supply 





16 

DSR 

DCD* pin; used on lie as Data Set Ready input 





17 

EXTINT* 

DSR* pin; used on lie as 

External interrupt (port 1 ACIA), or 






KSTRB 

Keyboard strobe input (port 2 ACIA; Appendix E) 





18-25 

D0-D7 

8-bit data bus 





26 

IRQ* 

Interrupt Request input 





27 

00 

Phase 0 clock pulse 





28 

R/W* 

Read/write select input 
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Figurell-30. Serial Port Connectors 



2 TD1B TD2B 

3 GND GND 

4 RD1B RD2B 

5 DSR1B DSR2B 


Table 11-20. Serial Port Connector Signals 


Pin# 

Name 

Description 

1 

DTR1B 

DTR2B 

Data Terminal Ready output 

2 

TD1B 

TD2B 

Transmit Data output 

3 

GND 

Power and signal common 

4 

RD1B 

RD2B 

Read Data input 

5 

DSR1B 

DSR2B 

Data Set Ready input 


11.11.1 ACIA Control Register 

Figure 11-31 shows the bit assignments for the ACIA control register, which 
the hardware locates at address $C09B for serial port 1, and $C0AB for 
serial port 2. This register determines the number of data and stop bits the 
ACIA will transmit and receive, and the clock source and baud rate to use 
for data transfer. 


11.11 Serial I/O 
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The receiver clock source is derived from the Apple He’s TMG chip; the 
resulting baud rates are equal to or up to 2 percent lower than the nominal 
rate. (The EIA standard allows plus or minus 2 percent variation.) If an 
Apple lie serial port is used with a modem that is 2 percent above the 
nominal rate, framing errors can occur, especially at 1200 baud and above, 
when using eight data bits. It may be necessary to select a lower baud rate 
for 8-bit binary data transfers. 


Figure 11-31. ACIA Control Register 

Copyright 1978, Synerteklnc. Used by_penmsion ofSyneriekh ie., SOOlStender Santa Clara , CA 95052. 


Port 1 = $C09B 
Port 2 = $COAB 
Control Register 


Stop Bits 


0 = 1 stop bit 


1=2 stop bits 


1 stop bit if word length 

= 8 bits and 

parity** 

IV 2 stop bits 

if word length 

= 5 bits and 

no parity 


Word Length 


Bit 

Data Word 
Length 

6 

5 

0 

0 

8 

0 

1 

7 

1 

0 

6 

1 

1 

5 


Receiver Clock Source 


0 = External receiver clock 

1 = Baud rate generator 


7 

6 

5 

4 

3 

2 

1 

0 


Baud Rate Generator 


0 

0 

0 

0 

16x External Clock 

0 

0 

0 

1 

50 baud 

0 

0 

1 

0 

75 

0 

0 

1 

1 

109.92 

0 

1 

0 

0 

134.58 

0 

1 

0 

1 

150 

0 

1 

1 

0 

300 

0 

1 

1 

1 

600 

1 

0 

0 

0 

1200 

1 

0 

0 

1 

1800 

1 

0 

1 

0 

2400 

1 

0 

1 

1 

3600 

1 

1 

0 

0 

4800 

1 

1 

0 

1 

7200 

1 

1 

1 

0 

9600 

1 

1 

1 

1 

19200 


**This allows for 9-bit transmission (8 data plus parity). 


7 6 5 4 3 2 1 0 

Hardware Reset 
Program Reset 
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11.11.2 ACIA Command Register 


Figure 11-32 shows the bit assignments for the ACIA command register, 
which the hardware locates at address $C09A for serial port 1, and at 
$C0AA for serial port 2. This register controls specific transmit and receive 
functions: parity checking, echoing input to output, allowing transmit and 
receive interrupts, and setting levels for Data Terminal Ready and Request 
to Send. 


Figure 11-32. ACIA Command Register 

Copyright 1978, Synertek Inc. Used by_ permission oj_ Synertek Inc., 3001. Stender, Santa Clara, CA 95052 


Port 1 = SC09A 
Port 2 = $C0AA 
Command Register 



Parity Check Controls 


Bit 

Operation 

7 

6 

5 

- 

- 

0 

Parity disabled— no parity bit 
generated, no parity bit received 

0 

0 

1 

Odd parity received and transmitted 

0 

1 

1 

Even parity received and transmitted 

1 

0 

1 

MARK parity bit transmitted; 
received parity check disabled 

1 

1 

1 

SPACE parity bit transmitted; 
received parity check disabled 


Normal Echo Mode 

for Receiver 

0 = Normal 

1 = Echo (bits 2 and 3 must be zero) 

7 6 


Data Terminal Ready 

0 = Disable receiver and all 

interrupts (DTR* high) 

1 = Enable receiver and all 

interrupts (DTR* low) 


Receiver Interrupt Enable 

0 = IRQ* interrupt enabled from bit 3 

of status register 

1 = IRQ* interrupt disabled 


Transmitter Controls 


Bit 

Transmit 

RTS* 

Transmitter 

3 

2 

Interrupt 

Level 


0 

0 

Disabled 

High 

Off 

0 

1 

Enabled 

Low 

On 

1 

0 

Disabled 

Low 

On 

1 

1 

Disabled 

Low 

Transmit BRK 


Hardware Reset 

0 

0 

0 

0 

0 

0 

0 

0 

Program Reset 

- 

- 

- 

0 

0 

0 

0 

0 
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11.11.3 ACIA Status Register 


Figure 11-33 shows the bit assignments for the ACIA status register, which 
is hard-wired to address $C099 for serial port 1, and $C0A9 for serial port 2. 
This register reports the condition of the transmit/receive register, errors 
detected during data transfer, and the level of the Data Carrier Detect, Data 
Set Ready, and Interrupt Request lines. 


Figure 11-33. ACIA Status Register 

Copyright 1978, Synerteklnc. Used by permission ofSynerteklnc., 3001 Stender, 
Santa Clara, CA 95052. 


7 

6 

5 

4 

3 

2 

1 

0 



Port 1 = $C099 
Port 2 = $C0A9 


Status 

Set By 

Cleared By 

Parity errorf 

0 = No error 

1 = Error 

Self-clearing** 

Framing errorf 

0 = No error 

1 = Error 

Self-clearing** 

Overrunf 

0 = No error 

1 = Error 

Self-clearing** 

Receive Data, 
Register full 

0 = Not full 

1 = Full 

Reading receive 
data register 

Transmit Data, 
Register empty 

0 = Not empty 

1 = Empty 

Writing to transmit 
data register 

DCD* 

0 = DCD* low 

1 = DCD* high 

Not resettable; 
reflects DCD* 
state 

DSR* 

0 = DSR* low 

1 = DSR* high 

Not resettable; 
reflects DSR* 
state 

IRQ 

0 = No interrupt 

1 = Interrupt 

Reading status 
register 


t No interrupt generated for these conditions. 
** Cleared automatically after a read of RDR 
and the next error-free receipt of data. 


7 6 5 4 3 2 1 0 

Hardware Reset 
Program Reset 
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11.11.4 ACIA Transmit/ Receive Register 


Each ACIA uses the same address— $C098 for serial port 1, $C0A8 for serial 
port 2— as temporary storage for both transmission and reception of data. 

When the register is used for transmitting data, bit 0 is the leading bit to be 
transmitted; unused data bits are the high-order bits, which are ignored. 

When the register is used for receiving data, bit 0 is the first bit received; 
unused data bits are the high-order bits, which are set to 0. Parity bits never 
appear in the receive data register; they are stripped off after being used for 
external parity checking. 


11.12 Mouse Input 


The mouse is a hand-held X-Y pointing device that can be rolled along a flat 
surface. It has an attached pushbutton. This section describes how mouse 
movement and direction can be detected and interpreted. 

A mouse has a ball inside its housing that protrudes a small distance so that 
its turning corresponds to mouse movements across a table top. Two wheels 
inside the housing, set at 90-degree angles to each other, follow movements 
of the ball; this causes two disks to rotate. The disks have rectangular holes 
arranged near their edges, making them resemble circular slide mounts 
used with stereoscopic slide viewers. 

The light from a tiny infrared emitter reaches a photoreceptor whenever 
one of the holes on the disk lies between them. An internal circuit in the 
mouse causes the resulting voltage to swing quickly to a 1 or a 0 value as 
soon as a certain threshold is crossed. The result is something 
approximating a square wave (Figure 11-34) that varies directly with the 
speed of mouse movement. One of these indicates the X component (X0) of 
mouse movement; the other, the Y component (Y0). 

Figure 11-34. Sample Mouse Waveform 

rsr _j i 


Mouse 

Speed 
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Under program control, either the rising edge or the falling edge of each 
square wave can cause an interrupt, which the firmware handles by 
updating a counter. However, the program needs to know whether to add or 
to subtract 1 from a counter; that is, it needs to know the direction of X or 
Y movement. 

There is a second infrared emitter/photoreceptor pair almost 180 degrees 
opposite the first pair for each disk. These pairs are positioned in such a 
way that the square waves they generate are approximately a quarter- wave 
offset from their respective movement waves (Figure 11-35). These 
waveforms are called XI (X direction) and Y1 (Y direction). 


Figure 11-35. Mouse Movement and Direction Waveforms 


+ tV 

\* 


Mouse 

Movement 


+X 


xo 

(XMOVE) 



XI 

(XDIR) 


+ X 


(ymove) _j 

< ydir > j Jiimjinmnnrmmu - 

When a rising edge of XO causes an interrupt, a mouse-driver program can 
immediately check whether XI is 0 (indicating a movement to the right) 
or 1 (indicating a movement to the left). Similarly, the mouse driver can 
read Y1 immediately after a Y0 interrupt to determine whether the mouse 
moved up or down one count along the Y axis. 

Figure 11-36 shows the pin assignments for the mouse DB-9 connector on 
the back panel. Table 11-21 gives the signal names and descriptions. 
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Figurell-36. Mouse Connector 



Signal 

MOUSEID* 

+5V 

GND 

XDIR 

XMOVE 

(N.C.) 

MSW* 

YDIR 

YMOVE 


Table 11-21. Mouse Connector Signals 


Pin # 

Name 

Description 

1 

MOUSEID* 

Mouse identifier: when active, disables NE556 hand 
controller timer 

2 

+5V 

Total current drain from this pin must not exceed 
100 mA. 

3 

GND 

System ground 

4 

XDIR 

Mouse X-direction indicator 

5 

XMOVE 

Mouse X-movement interrupt 

6 

N.C. 

Not connected 

7 

MSW* 

Mouse button 

8 

YDIR 

Mouse Y-direction indicator 

9 

YMOVE 

Mouse Y-movement interrupt 


Figure 11-37 shows the mouse and hand controller circuitry with the mouse 
circuits emphasized. Figure 11-38 illustrates the values of the mouse-button 
circuit when the button is pressed or not pressed. Pressing the button 
disables the NE556 by pulling the reset comparator threshold value up so 
that it cannot reset the flip flop. As a result the mouse-button input value 
remains at a TTL level. 


11.12 Mouse Input. 
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Figure 11-37. Mouse Circuits 
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f 
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■ 512 


ft 


7 10 _J 




C07X 

-x— a 


DISCHARGE 

THRESHOLD 


TRIG OUT 
CTRL 


CTRL 

TRIG OUT 

DISCHARGE 

THRESHOLD 


S5 


S5 


SJKb 
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°v 
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A1 
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A2 


8 to 1 
MUX 
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Address Bus 


Figure 11-38. Mouse Button Signals 


Input Current 
(mA) 
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11.13 Hand Controller Input 


Several input signals that are individually controlled via soft switches are 
collectively referred to as the hand controller (game) signals. These signals 
arrive in the Apple lie via the same DB-9 connector as the one used for the 
mouse (Section 11.12), but the Apple lie interprets these signals differently. 

The DB-9 connector pin assignments and signal descriptions, as used for 
hand controller input, appear in Figure 11-39 and Table 11-22. 

Even though they are normally used for hand controllers, these signals can 
be used for other simple I/O applications. There are two 1-bit switch inputs, 
labeled SwO and Swl, and two analog inputs, called paddles and labeled 
PdlO and Pdll. Figure 11-40 shows how to connect the 1-bit switch inputs 
for compatibility with all other Apple II series computers. 

The switch inputs are multiplexed by a 74LS251 8-to-l multiplexer enabled 
by the C06X* signal from the MMU. Depending on the low-order address, the 
appropriate game input is connected to bit 7 of the data bus. Figure 11-41 
shows the mouse and hand controller circuitry with the hand controller 
circuits highlighted. Figure 11-42 illustrates the values of the hand 
controller switch inputs when the switch is open or closed. 


Figure 11-39. Hand Controller Connector 




Signal 

GAMES W1 

+5V 

GND 

Not used for hand controllers 
PDLO 


(N.C.) 

GAMESWO 

PDL1 

Not used for hand controllers 
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Table 11-22. Hand Controller Connector Signals 


Pin # 

Name 

Description 

1 

GAMESW1 

Switch input 1 (sometimes called paddle button 1) 

2 

+5V 

+5V power supply; total current drain from this pin 
must not exceed 100 mA. 

3 

GND 

System ground 

4,9 


Not used for hand controllers 

5,8 

PDLO and 
PDL1 

Hand controller inputs; each of these must be 
connected to a 150-Kft variable resistor connected 
to +5V. 

6 

N.C. 

Not connected 

7 

GAMESWO 

Switch input 0 (sometimes called paddle button 0) 


Figure 11-40. How to Connect Switch Inputs 



Switch: OK 


+ 5 



^30mA 


Saturated: OK 


+ 5 



Schottky: NO Ground Level: NO Emitter Follower: NO 
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Figure 11-41. Hand Controller Circuits 


C06X 
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GND 


470 12 ^ 80/40 Column 
Switch 


ir 1 
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Address Bus 


Figure 1142. Hand Controller Signals 


Input Current 
(mA) 
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▲Warning 

The hand controller inputs are connected to the timing inputs of an NE556 
dual analog timer. Addressing $C07X sends a signal from MMU pin 22 that 
resets both timers and causes their outputs to go to 1 (high). A variable 
resistance of up to 150 KO connected between one of these inputs and the 
+5V supply controls the charging time of one of the two 0.022 microfarad 
capacitors. 

When the voltage on the capacitor passes a certain threshold, the output of 
the NE556 changes back to 0 (low). Programs can determine the setting of a 
variable resistor by resetting the timers and then counting time until the 
selected timer input changes from high to low. The resulting count is 
proportional to the resistance. 

The only way to ensure correct paddle values is to make sure the output 
of the paddle you intend to read is low before you trigger the timer. 
Triggering the timer starts the charging cycle for the capacitor in each 
paddle circuit; the cycle for one may not be completed by the time you 
have read the other. If you retrigger or read the other paddle too soon 
(that is, in less than 3 ms), you will get a false value for it. 

11.14 Schematic Diagrams 


The following pages contain schematic diagrams for the Apple lie. 
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This appendix describes the differences between the 6502 and the 65C02 
microprocessors. It also contains the data sheet for the NCR 65C02 
microprocessor. 

In the data sheet tables, execution times are specified in numbers of cycles. 
One cycle for the Apple lie equals 0.978 microseconds. 

If you want to write programs that execute on all computers in the Apple II 
series, make sure your code uses only the subset of 65C02 instructions 
present on the 6502. 


A.1 Differences Between 6502 and 65C02 


The data sheet in Section A.2 lists the new 65C02 instructions and 
addressing modes. This section supplements that information by listing the 
instructions whose execution times or results have changed from their 6502 
counterparts. 


A. 1.1 Differing Cycle Times 

In general, differences in execution times are significant only in 
time-dependent code, such as precise wait loops. Fortunately, instructions 
with changed execution times are few. 

Table A-l lists the 65C02 instructions whose number of instruction 
execution cycles is different from their number on the 6502. 


Table A-l. Cycle Time Differences 


Instruction/Mode 

Opcode 

6502 

Cycles 

65C02 

Cycles 

ASL Absolute, X 

IE 

7 

6 

DEC Absolute, X 

DE 

7 

6 

INC Absolute, X 

FE 

7 

6 

JMP (Absolute) 

6C 

5 

6 

LSR Absolute, X 

5E 

7 

6 

ROL Absolute, X 

3E 

7 

6 

ROR Absolute, X 

7E 

7 

6 
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A. 1.2 Differing Instruction Results 


The instructions that have different results from their 6502 equivalents are 

□ BIT (in immediate mode) 

□ JMP (indirect, when crossing a page boundary). 

The BIT instruction when used in immediate mode (code $89) leaves 
processor status register bits 7 (N) and 6 (V) unchanged on the 65C02. On 
the 6502, all modes of the BIT instruction have the same effect on the status 
register: the value of memory bit 7 is placed in status bit 7, and memory 
bit 6 is placed in status bit 6. However, all BIT instructions on both versions 
of the processor set status bit 1 (Z) if the memory location being tested 
contains a 0. 

If the JMP indirect instruction (code $6C) references an indirect address 
location that spans a page boundary, the 65C02 fetches the high-order byte 
of the effective address from the first byte of the next page, while the 6502 
fetches it from the first byte of the current page. For example, JMP ($02FF) 
gets ADL from location $02FF on both processors. On the 65C02, ADH 
comes from $0300 while on the 6502, ADH comes from $0200. 


A.2 Data Sheet 


The rest of this appendix is copyright 1982, NCR Corporation, Dayton, Ohio, 
and is reprinted with their permission. 


A.2 Datasheet 


NCR65C02 


N C 




- GENERAL DESCRIPTION 


■ PIN CONFIGURATION 


The NCR CMOS 6502 is an 8-bit microprocessor which is soft- 
ware compatible with the NMOS 6502. The NCR65C02 hardware 
interfaces with all 6500 peripherals. The enhancements include 
ten additional instructions, expanded operational codes and 
two new addressing modes. This microprocessor has all of the ad- 
vantages of CMOS technology: low power consumption, increased 
noise immunity and higher reliability. The CMOS 6502 is a low 
power high performance microprocessor with applications in the 
consumer, business, automotive and communications market. 


■ FEATURES 

• Enhanced software performance including 27 additional OP codes 
encompassing ten new instructions and two additional 
addressing modes. 

• 66 microprocessor instructions. 

• 15 addressing modes. 


vss 

RDY 
0, (OUT) 
IRQ 
ML 
NMI 
SYNC 
VDD 
A0 
A1 
A2 
A3 
A4 
A5 
A6 
A7 
A8 
A9 
A10 
All 



RES 

0 2 (OUT) 
SO 

0 O (IN) 

NC 

NC 

R/W 

DO 

D1 

02 

D3 

D4 

D5 

06 

D7 

A15 

A 1 4 

A13 

A12 

VSS 


178 operational codes. 

1MHz, 2MHz operation. 

Operates at frequencies as low 

as 200 HZ for even lower power 

consumption (pseudo-static: stop during 02 high). 

Compatible with NMOS 6500 series 
microprocessors. 

64 K-byte addressable memory. 

Interrupt capability. 

Lower power consumption. 

4mA @ 1MHz. 

+5 volt power supply. 

8-bit bidirectional data bus. 

Bus Compatible with M6800. 

Non-maskable interrupt. 

ADDHES! 

40 pin dual-in-line packaging. Bus 
8-bit parallel processing 
Decimal and binary arithmetic. 

Pipeline architecture. 

Programmable stack pointer. 

Variable length stack. 

Option al int ernal pull ups for 

(RDY, IRQ, SO, NMI and RES) 


Specifications are subject to 
change without notice. 


■ NCR65C02 BLOCK DIAGRAM 



RDY 

SYNC 

STl 


OqIINI 


©1 (OUT! 
©2 (OUT) 
§ 5 _ 

R/W 


Copyright ©1982 by NCR Corporation, Dayton, Ohio, USA 
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NCR65C02 

■ ABSOLUTE MAXIMUM RATINGS: <v DD =5.ov ± 5%, V ss = 0 V, T A = 0° to + 70°C) 


RATING 

SYMBOL 

VALUE 

UNIT 

SUPPLY VOLTAGE 

V DD 

-0.3 to +7.0 

V 

INPUT VOLTAGE 

V, N 

-0.3 to +7.0 

V 

OPERATING TEMP. 

T A 

0 to + 70 

°c 

STORAGE TEMP. 

t stg 

—55 to + 150 

°c 


■ PIN FUNCTION 


PIN 

FUNCTION 

A0 - A15 

Address Bus 

DO - D7 

Data Bus 

IRQ * 

Interrupt Request 

RDY * 

Ready 

ML 

Memory Lock 

nmI* 

Non-Maskable Interrupt 

SYNC 

Synchronize 

RES* 

Reset 

SO* 

Set Overflow 

NC 

No Connection 

R/W 

Read/Write 

VDD 

Power Supply (+5V) 

VSS 

Internal Logic Ground 

00 

Clock Input 

01, 02 

Clock Output 


•This pin has an optional internal pullup for a No Connect condition. 


■ DC CHARACTERISTICS 



SYMBOL 

MIN. 

TYP. 

MAX 

UNIT 

Input High Voltage 

00 (IN) 

V, H 

Vss + 2.4 

_ 

Q 

O 

> 

V 

Input High Voltage 

RES, NMl, RDY, IRQ, Data, S.O. 


Vss + 2.0 

_ 

_ 

V 

Input Low Voltage 

00 ON) 

V|L 

V SS -0.3 


Vss + 0.4 

V 

RES, NMI, RDY, IRQ, Data, S.O. 


- 

- 

Vss + 0-8 

V 

Input Leakage Current 

( V| N = 0 to 5.25V, V DD = 5.25V) 

With pullups 

1 1 N 

-30 


+30 

^A 

Without pullups 


- 

- 

+ 1.0 

HA 

Three State (Off State) Input Current 
(V, N = 0.4 to 2.4V, V cc = 5.25V) 

Data Lines 

■tsi 



10 

ha 

Output High Voltage 

(l OH =-100 /i Adc, V dd =4.75V 

SYNC, Data, A0-A15, R/W) 

V OH 

Vss + 2.4 



V 

Out Low Voltage 

(l 0L = 1.6mAdc, V DD = 4.75V 

SYNC, Data, A0-A15, R/W) 

V 0 L 



V SS + 0.4 

V 

Supply Current f = 1MHz 

■dd 

- 

- 

4 

mA 

Supply Current f = 2MHz 

■dd 

- 

- 

8 

mA 

Capacitance 

(V, N =0, T a = 25°C, f = 1 MHz) 

Logic 

c 

Qn 



5 

PF 

Data 

A0-A15, R/W, SYNC 

Cout 

_ 

_ 

10 

10 


00 (IN) 

C0 O (IN) 

- 

— 

10 
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NCR65C02 

■ AC CHARACTERISTICS v DD = 5.0V + 5%, Ta = 0°C to 70°C, Load = 1 TTL + 130 pF 




IMhz 

2Mhz 

3Mhz 


Parameter 

Symbol 

Min 

Max 

Min 

Max 

Min 

Max 

Unit 

Delay Time, 0o (IN) to 02 (OUT) 

tDLY 

- 

60 

- 

60 

20 

60 

nS 

Delay Time, 0*| (OUT) to 02 (OUT) 

tDLYI 

-20 

20 

-20 

20 

-20 

20 

nS 

Cycle Time 

tCYC 

1.0 

5000* 

0.50 

5000* 

0.33 

5000* 

ns 

Clock Pulse Width Low 

tPL 

460 

- 

220 

- 

160 

- 

nS 

Clock Pulse Width High 

tpH 

460 

- 

220 

- 

160 

- 

nS 

Fall Time, Rise Time 

tF, tR 

- 

25 

- 

25 

- 

25 

nS 

Address Hold Time 

*AH 

20 

- 

20 

- 

0 

- 

nS 

Address Setup Time 

tADS 

- 

225 

- 

140 

- 

110 

nS 

Access Time 

UcC 

650 

- 

310 

- 

170 

- 

nS 

Read Data Hold Time 

tDHR 

10 

- 

10 

- 

10 

- 

nS 

Read Data Setup Time 

tDSU 

100 

- 

60 

- 

60 

- 

nS 

Write Data Delay Time 

tMDS 

- 

30 

- 

30 

- 

30 

nS 

Write Data Hold Time 

*DHW 

20 

- 

20 

- 

15 

- 

nS 

SO Setup Time 

tso 

100 

- 

100 

- 

100 

- 

nS 

Processor Control Setup Time** 

tpcs 

200 

- 

150 

- 

150 

- 

nS 

SYNC Setup Time 

tSYNC 

- 

225 

- 

140 

- 

100 

nS 

ML Setup Time 

tML 

- 

225 

- 

140 

- 

100 

nS 

Input Clock Rise/Fall Time 

tF0o,tR0 o 

- 

25 

- 

25 

- 

25 

nS 


*NCR65C02 can be held static with 0 2 high. 

**This parameter must only be met to guarantee that the signal will be recognized at the current clock cycle. 

■ MICROPROCESSOR OPERATIONAL ENHANCEMENTS 


Function 

NMOS 6502 Microprocessor 

NCR65C02 Microprocessor 

Indexed addressing across page boundary. 

Extra read of invalid address. 

Extra read of last instruction byte. 

Execution of invalid op codes. 

Some terminate only by reset. Results 
are undefined. 

All are* NOPs (reserved for future use). 
Op Code Bytes Cycles 

X2 2 2 

X3, X7, XB, XF 1 1 

44 2 3 

54, D4, F4 2 4 

5C 3 8 

DC, FC 3 4 

Jump indirect, operand = XXFF. 

Page address does not increment. 

Page address increments and adds one 
additional cycle. 

Read/modify/write instructions at 
effective address. 

One read and two write cycles. 

Two read and one write cycle. 

Decimal flag. 

Indeterminate after reset. 

Initialized to binary mode (D=0) after 
reset and interrupts. 

Flags after decimal operation. 

Invalid N, V and Z flags. 

Valid flag adds one additional cycle. 

Interrupt after fetch of BRK instruc- 
tion. 

Interrupt vector is loaded, BRK vector 
is ignored. 

BRK is executed, then interrupt is 
executed. 


■ MICROPROCESSOR HARDWARE ENHANCEMENTS 


Function 

NMOS 6502 

NCR65C02 

Assertion of Ready RDY during 
write operations. 

Ignored. 

Stops processor during 02- 

Unused input-only pins (IRQ, NMI, 
RDY, RES, SO). 

Must be connected to low impedance 
signal to avoid noise problems. 

Connected internally by a high- 
resistance to Vqd (approximately 250 
K ohm.) 
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NCR65C02 
■ TIMING DIAGRAM 


00 

01 

02 

ADDR, R/W 
READ DATA 

WRITE DATA 

SYNC 

ML 


RDY, IRQ 
NMI, RES 


SO 




h-t D 


h* t Rgo 


IF 




Urn- l F0() 



Note: All timing is referenced from a high voltage of 2.0 volts and a low voltage of 0.8 volts. 


■ NEW INSTRUCTION MNEMONICS 


HEX 

MNEMONIC 

DESCRIPTION 

80 

BRA 

Branch relative always [Relative] 

3A 

DEA 

Decrement accumulator [Accum] 

1 A 

INA 

Increment accumulator [Accum] 

DA 

PHX 

Push X on stack [Implied] 

5A 

PHY 

Push Y on stack [Implied] 

FA 

PLX 

Pull X from stack [Implied] 

7A 

PLY 

Pull Y from stack [Implied] 

9C 

STZ 

Store zero [Absolute] 

9E 

STZ 

Store zero [ABS, X] 

64 

STZ 

Store zero [Zero page] 

74 

STZ 

Store zero [ZPG,X] 

1C 

TRB 

Test and reset memory bits with accumulator [Absolute] 

14 

TRB 

Test and reset memory bits with accumulator [Zero page] 

OC 

TSB 

Test and set memory bits with accumulator [Absolute] 

04 

TSB 

Test and set memory bits with accumulator [Zero page] 


■ ADDITIONAL INSTRUCTION ADDRESSING MODES 


HEX 

MNEMONIC 

72 

ADC 

32 

AND 

3C 

BIT 

34 

BIT 

D2 

CMP 

52 

EOR 

7C 

JMP 

B2 

LDA 

12 

ORA 

F2 

SBC 

92 

STA 


DESCRIPTION 

Add memory to accumulator with carry [ (ZPG ) ] 

"AND” memory with accumulator [(ZPG)] 

Test memory bits with accumulator [ABS, X] 

Test memory bits with accumulator [ZPG, X] 

Compare memory and accumulator [(ZPG)] 

"Exclusive Or" memory with accumulator [(ZPG)] 

Jump (New addressing mode) [ABS(IND,X)] 

Load accumulator with memory [(ZPG)j 
"OR" memory with accumulator [(ZPG)] 

Subtract memory from accumulator with borrow [(ZPG)] 
Store accumulator in memory [(ZPG)] 
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- MICROPROCESSOR PROGRAMMING MODEL 


7 0 



1 — 

A 

ZJ 


7 


0 


| 

Y 

1 


7 


0 


1 

X 

I 

15 

7 


0 

1 PCH 

~r~ 

PCL 

1 


8 7 


0 


LU 

S 

1 


ACCUMULATOR A 
INDEX REGISTER Y 
INDEX REGISTER X 
PROGRAM COUNTER PC 
STACK POINTER S 


7 0 

| N | V | 1 | B | D | I | Z|C~1 pEQ^. E p ^ S0R STATUS 

CARRY 1 = TRUE 

ZERO 1 = RESULT ZERO 

IRQ DISABLE 1 = DISABLE 

DECIMAL MODE 1 = TRUE 

BRK COMMAND 1 = BRK 

OVERFLOW 1 = TRUE 

NEGATIVE 1 = NEG. 


■ FUNCTIONAL DESCRIPTION 


Timing Control 

The timing control unit keeps track of the instruction 
cycle being monitored. The unit is set to zero each time 
an instruction fetch is executed and is advanced at the 
beginning of each phase one clock pulse for as many 
cycles as is required to complete the instruction. Each 
data transfer which takes place between the registers de- 
pends upon decoding the contents of both the instruc- 
tion register and the timing control unit. 

Program Counter 

The 16-bit program counter provides the addresses which 
step the microprocessor through sequential instructions 
in a program. 

Each time the microprocessor fetches an instruction 
from program memory, the lower byte of the program 
counter (PCL) is placed on the low-order bits of the 
address bus and the higher byte of the program counter 
(PCH) is placed on the high-order 8 bits. The counter is 
incremented each time an instruction or data is fetched 
from program memory. 

Instruction Register and Decode 

Instructions fetched from memory are gated onto the 
internal data bus. These instructions are latched into the 
instruction register, then decoded, along with timing and 
interrupt signals, to generate control signals for the var- 
ious registers. 

Arithmetic and Logic Unit (ALU) 

All arithmetic and logic operations take place in the 
ALU including incrementing and decrementing internal 
registers (except the program counter). The ALU has no 
internal memory and is used only to perform logical and 
transient numerical operations. 


Accumulator 

The accumulator is a general purpose 8-bit register that 
stores the results of most arithmetic and logic operations, 
and in addition, the accumulator usually contains one of 
the two data words used in these operations. 

Index Registers 

There are two 8-bit index registers (X and Y), which 
may be used to count program steps or to provide an 
index value to be used in generating an effective address. 
When executing an instruction which specifies indexed 
addressing, the CPU fetches the op code and the base 
address, and modifies the address by adding the index 
register to it prior to performing the desired operation. 
Pre- or post-indexing of indirect addresses is possible (see 
addressing modes). 

Stack Pointer 

The stack pointer is an 8-bit register used to control the 
addressing of the variable-length stack on page one. The 
stack pointer is automatically incremented and decre- 
mented under control of the microprocessor to perform 
stack manipula tion s unde r dir ection of either the program 
or interrupts (NMI and IRQ). The stack allows simple 
implementation of nested subroutines and multiple level 
interrupts. The stack pointer should be initialized before 
any interrupts or stack operations occur. 

Processor Status Register 

The 8-bit processor status register contains seven status 
flags. Some of the flags are controlled by the program, 
others may be controlled both by the program and the 
CPU. The 6500 instruction set contains a number of 
conditional branch instructions which are designed to 
allow testing of these flags (see microprocessor program- 
ming model). 
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NCR65C02 

■ ADDRESSING MODES 

Fifteen addressing modes are available to the user of the 
NCR65C02 microprocessor. The addressing modes are 
described in the following paragraphs: 

Implied Addressing [Implied] 

In the implied addressing mode, the address containing 
the operand is implicitly stated in the operation code of 
the instruction. 

Accumulator Addressing [Accum] 

This form of addressing is represented with a one byte 
instruction and implies an operation on the accumu- 
lator. 

Immediate Addressing [Immediate] 

With immediate addressing, the operand is contained in 
the second byte of the instruction; no further memory 
addressing is required. 

Absolute Addressing [Absolute] 

For absolute addressing, the second byte of the instruc- 
tion specifies the eight low-order bits of the effective 
address, while the third byte specifies the eight high-order 
bits. Therefore, this addressing mode allows access to the 
total 64K bytes of addressable memory. 

Zero Page Addressing [Zero Page] 

Zero page addressing allows shorter code and execution 
times by only fetching the second byte of the instruction 
and assuming a zero high address byte. The careful use 
of zero page addressing can result in significant increase 
in code efficiency. 

Absolute Indexed Addressing [ABS, X or ABS, Y] 

Absolute indexed addressing is used in conjunction with 
X or Y index register and is referred to as “Absolute, X,” 
and “Absolute, Y.“ The effective address is formed by 
adding the contents of X or Y to the address contained 
in the second and third bytes of the instruction. This 
mode allows the index register to contain the index or 
count value and the instruction to contain the base 
address. This type of indexing allows any location refer- 
encing and the index to modify multiple fields, resulting 
in reduced coding and execution time. 

Zero Page Indexed Addressing [ZPG, X or ZPG, Y] 

Zero page absolute addressing is used in conjunction 
with the index register and is referred to as “Zero Page, 
X" or “Zero Page, Y.“ The effective address is calculated 
by adding the second byte to the contents of the index 
register. Since this is a form of “Zero Page" addressing, 
the content of the second byte references a location in 
page zero. Additionally, due to the “Zero Page" address- 
ing nature of this mode, no carry is added to the high- 
order eight bits of memory, and crossing of page boun- 
daries does not occur. 

Relative Addressing [Relative] 

Relative addressing is used only with branch instructions; 


it establishes a destination for the conditional branch. 
The second byte of the instruction becomes the operand 
which is an "Offset" added to the contents of the pro- 
gram counter when the counter is set at the next in- 
struction. The range of the offset is -128 to +127 
bytes from the next instruction. 

Zero Page Indexed Indirect Addressing [(IND, X)] 

With zero page indexed indirect addressing (usually re- 
ferred to as indirect X) the second byte of the instruction 
is added to the contents of the X index register; the 
carry is discarded. The result of this addition points to a 
memory location on page zero whose contents is the low- 
order eight bits of the effective address. The next mem- 
ory location in page zero contains the high-order eight 
bits of the effective address. Both memory locations 
specifying the high- and low-order bytes of the effective 
address must be in page zero. 

"Absolute Indexed Indirect Addressing [ABS(IND, X)] 
(Jump Instruction Only) 

With absolute indexed indirect addressing the contents of 
the second and third instruction bytes are added to the 
X register. The result of this addition, points to a memory 
location containing the lower-order eight bits of the 
effective address. The next memory location contains 
the higher-order eight bits of the effective address. 

Indirect Indexed Addressing [(IND), Y] 

This form of addressing is usually referred to as Indirect, 
Y. The second byte of the instruction points to a mem- 
ory location in page zero. The contents of this memory 
location are added to the contents of the Y index regis- 
ter, the result being the low-order eight bits of the effec- 
tive address. The carry from this addition is added to the 
contents of the next page zero memory location, the 
result being the high-order eight bits of the effective 
address. 

"Zero Page Indirect Addressing [(ZPG)] 

In the zero page indirect addressing mode, the second 
byte of the instruction points to a memory location on 
page zero containing the low-order byte of the effective 
address. The next location on page zero contains the 
high -order byte of the effective address. 

Absolute Indirect Addressing [(ABS)] 

(Jump Instruction Only) 

The second byte of the instruction contains the low-order 
eight bits of a memory location. The high-order eight 
bits of that memory location is contained in the third 
byte of the instruction. The contents of the fully speci- 
fied memory location is the low-order byte of the effec- 
tive address. The next memory location contains the 
high-order byte of the effective address which is loaded 
into the 16 bit program counter. 

NOTE: * = New Address Modes 
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- SIGNAL DESCRIPTION 


NCR65C02 


Address Bus (A0-A15) 

A0-A15 forms a 16-bit address bus for memory and I/O 
exchanges on the data bus. The output of each address 
line is TTL compatible, capable of driving one standard 
TTL load and 130pF. 

Clocks (0 q, 0i, and 02) 

00 is a TTL level input that is used to generate the inter- 
nal clocks in the 6502. Two full level output clocks are 
generated by the 6502. The 02 clock output is in phase 
with 0 q. The 0i output pin is 180° out of phase with 0 q. 
(See timing diagram.) 

Data Bus (D0-D7) 

The data lines (D0-D7) constitute an 8-bit bidirectional 
data bus used for data exchanges to and from the device 
and peripherals. The outputs are three-state buffers 
capable of driving one TTL load and 130 pF. 

Interrupt Request (IRQ) 

This TTL compatible input requests that an in terru pt 
sequence begin within the microprocessor. The IRQ is 
sampled during 02 operation; if the interrupt flag in the 
processor status register is zero, the current instruction 
is completed and the interrupt sequence begins during 
01. The program counter and processor status register 
are stored in the stack. The microprocessor will th en set 
the interrupt mask flag high so that no further IRQs 
may occur. At the end of this cycle, the program counter 
low will be loaded from address FFFE, and program 
counter high from location FFFF, transferring program 
control to the memory vector located at these addresses. 
The RDY signal must be in the high state for any inter- 
rupt to be tecognized. A 3K ohm external resistor should 
be used for proper wire OR operation. 

Memory Lock (ML) 

In a multiprocessor system, the ML output indicates the 
need to defer the rearbitration of the next bus cycle to 
ensure the integrity of read-modify-write instructions. 
ML goes low during ASL, DEC, INC, LSR, ROL, ROR, 
TRB, TSB memory referencing instructions. This signal 
is low for the modify and write cycles. 

Non-Maskable Interrupt (NMI) 

A negative-going edge on this input requests that a non- 
maskable interrupt sequ ence be generated within the 
microprocessor. The NMI is sampled during 02; the cur- 
rent instruction is completed and the interrupt sequence 
begins during 0i. The program counter is loaded with 
the interrupt vector from locations FFFA (low byte) 
and FFFB (high byte), thereby transferring program con- 
trol to the non-maskable interrupt routine. 


Ready (RDY) 

This input allows the user to single-cycle the micropro- 
cessor on all cycles including write cycles. A negative 
transition to the low state, during or coincident with 
phase one (0i ), will halt the microprocessor with the out- 
put address lines reflecting the current address being 
fetched. This condition will remain through a subsequent 
phase two (02) in which the ready signal is low. This fea- 
ture allows microprocessor interfacing with low-speed 
memory as well as direct memory access (DMA). 

Reset (RES) 

This input is used to reset the microprocessor. Reset 
must be held low for at least two clock cycles after 
Vdd reaches operating voltage from a power down. A 
positive transistion on this pin will then cause an initiali- 
zation sequence to begin. Likewise, after the system has 
been operating, a low on this line of at least two cycles 
will cease microprocessing activi ty, f ollowed by initial- 
ization after the positive edge on RES. 

When a positive edge is detected, there is an initialization 
sequence lasting six clock cycles. Then the interrupt 
mask flag is set, the decimal mode is cleared, and the pro- 
gram counter is loaded with the restart vector from loca- 
tions FFFC (low byte) and FFFD (high byte). This is 
the start location for program control. This input should 
be high in normal operation. 

Read/Write (R/W) 

This signal is normally in the high state indicating that 
the microprocessor is reading data from memory or I/O 
bus. In the low state the data bus has valid data from the 
microprocessor to be stored at the addressed memory 
location. 

Set Overflow (SO) 

A negative transition on this line sets the overflow bit in 
the status code register. The signal is sampled on the trail- 
ing edge of 0i. 

Synchronize (SYNC) 

This output line is provided to identify those cycles dur- 
ing which the microprocessor is doing an OP CODE 
fetch. The SYNC line goes high during 0i of an OP CODE 
fetch and stays high for the remainder of that cycle. If 
the RDY line is pulled low during the 0i clock pulse in 
which SYNC went high, the processor will stop in its 
current state and will remain in the state until the RDY 
line goes high. In this manner, the SYNC signal can be 
used to control RDY to cause single instruction execu- 
tion. 


Note; Since this interrupt is non-maskable, another NMI 
can occur b efore the first is finished. Care should be taken 
when using NMI to avoid this. 
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NCR65C02 

■ INSTRUCTION SET — ALPHABETICAL SEQUENCE 


ADC Add Memory to Accumulator with Carry 
AND "AND" Memory with Accumulator 
ASL Shift One Bit Left 
BCC Branch on Carry Clear 
BCS Branch on Carry Set 
BEQ Branch on Result Zero 
BIT Test Memory Bits with Accumulator 
BMI Branch on Result Minus 
BNE Branch on Result not Zero 
BPL Branch on Result Plus 
‘BRA Branch Always 
BRK Force Break 
BVC Branch on Overflow Clear 
BVS Branch on Overflow Set 
CLC Clear Carry Flag 
CLD Clear Decimal Mode 
CLI Clear Interrupt Disable Bit 
CLV Clear Overflow Flag 
CMP Compare Memory and Accumulator 
CPX Compare Memory and Index X 
CPY Compare Memory and Index Y 

* DEA Decrement Accumulator 
DEC Decrement by One 

DEX Decrement Index X by One 
DEY Decrement Index Y by One 
EOR “Exclusive- or” Memory with Accumulator 

• INA Increment Accumulator 
INC Increment by One 

INX Increment Index X by One 
INY Increment Index Y by One 
JMP Jump to New Location 

JSR Jump to New Location Saving Return Address 
LDA Load Accumulator with Memory 

Note: * = New Instruction 


LDX Load Index X with Memory 
LDY Load Index Y with Memory 
LSR Shift One Bit Right 
NOP No Operation 

ORA "OR" Memory with Accumulator 

PHA Push Accumulator on Stack 

PHP Push Processor Status on Stack 

PHX Push Index X on Stack 

PHY Push Index Y on Stack 

PLA Pull Accumulator from Stack 

PLP Pull Processor Status from Stack 

PLX Pull Index X from Stack 

PLY Pull Index Y from Stack 

ROL Rotate One Bit Left 

ROR Rotate One Bit Right 

RTI Return from Interrupt 

RTS Return from Subroutine 

SBC Subtract Memory from Accumulator with Borrow 

SEC Set Carry Flag 

SED Set Decimal Mode 

SEI Set Interrupt Disable Bit 

STA Store Accumulator in Memory 

STX Store Index X in Memory 

STY Store Index Y in Memory 

STZ Store Zero in Memory 

TAX Transfer Accumulator to Index X 

TAY Transfer Accumulator to Index Y 

TRB Test and Reset Memory Bits with Accumulator 

TSB Test and Set Memory Bits with Accumulator 

TSX Transfer Stack Pointer to Index X 

TXA Transfer Index X to Accumulator 

TXS Transfer Index X to Stack Pointer 

TYA Transfer Index Y to Accumulator 


■ MICROPROCESSOR OP CODE TABLE 


s 

D 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 


0 

BRK 

ORA 



TSB* 

ORA 

ASL 


PHP 

ORA 

ASL 


TSB* 

ORA 

ASL 


0 



ind, X 



zpg 

zpg 

zpg 



imm 

A 


abs 

abs 

abs 



1 

BPL 

ORA 

ORA* t 


TRB* 

ORA 

ASL 


CLC 

ORA 

INA* 


TRB* 

ORA 

ASL 


1 


rel 

ind, Y 

(zpg) 


zpg 

zpg, X 

zpg, X 



abs, Y 

A 


abs 

abs, X 

abs, X 



2 

JSR 

AND 



BIT 

AND 

ROL 


PLP 

AND 

ROL 


BIT 

AND 

ROL 


2 


abs 

ind, X 



zpg 

zpg 

zpg 



imm 

A 


abs 

abs 

abs 



3 

BMI 

AND 

AND* t 


BIT* 

AND 

ROL 


SEC 

AND 

DEA* 


BIT* t 

AND 

ROL 


3 


rel 

ind, Y 

(zpg) 


zpg, x 

zpg, X 

zpg, X 



abs, Y 

A 


abs, X 

abs, X 

abs, X 



4 

RTI 

EOR 




EOR 

LSR 


PHA 

EOR 

LSR 


JMP 

EOR 

LSR 


4 



ind, X 




zpg 

zpg 



imm 

A 


abs 

abs 

abs 



5 

BVC 

EOR 

EOR * t 



EOR 

LSR 


CLI 

EOR 

PHY* 



EOR 

LSR 


5 


rel 

ind, Y 

(zpg) 



zpg, X 

zpg. X 



abs, Y 




abs, X 

abs, X 



6 

RTS 

ADC 



STZ* 

ADC 

ROR 


PLA 

ADC 

ROR 


JMP 

ADC 

ROR 


6 



ind, X 



zpg 

zpg 

zpg 



imm 

A 


(abs) 

abs 

abs 



7 

BVS 

ADC 

ADC* t 


STZ* 

ADC 

ROR 


SEI 

ADC 

PLY* 


JMP* t 

ADC 

ROR 


7 


rel 

ind, Y 

(zpg) 


zpg, X 

zpg, X 

zpg, x 



abs, Y 



abs (ind, X) 

abs, X 

abs, X 



8 

BRA* 

STA 



STY 

STA 

STX 


DEY 

BIT* 

TXA 


STY 

STA 

STX 


8 


rel 

ind, X 



zpg 

zpg 

zpg 



imm 



abs 

abs 

abs 



9 

BCC 

STA 

STA* t 


STY 

STA 

STX 


TYA 

STA 

TXS 


STZ* 

STA 

STZ* 


9 


rel 

ind, Y 

(zpg) 


zpg, X 

zpg, x 

zpg. Y 



abs, Y 



abs 

abs, X 

abs, X 



A 

LDY 

LDA 

LDX 


LDY 

LDA 

LDX 


TAY 

LDA 

TAX 


LDY 

LDA 

LDX 


A 


imm 

ind. X 

imm 


zpg 

zpg 

zpg 



imm 



abs 

abs 

abs 



B 

BCS 

LDA 

LDA * t 


LDY 

LDA 

LDX 


CLV 

LDA 

TSX 


LDY 

LDA 

LDX 


B 


rel 

ind, Y 

(zpg) 


zpg, x 

zpg, X 

zpg. Y 



abs, Y 



abs, X 

abs. X 

abs, Y 



C 

CPY 

CMP 



CPY 

CMP 

DEC 


INY 

CMP 

DEX 


CPY 

CMP 

DEC 


C 


imm 

ind, X 



zpg 

zpg 

zpg 



imm 



abs 

abs 

abs 



D 

BNE 

CMP 

CMP* t 



CMP 

DEC 


CLD 

CMP 

PHX* 



CMP 

DEC 


D 


rel 

ind, Y 

(zpg) 



zpg, X 

zpg, X 



abs, Y 




abs. X 

abs, X 



E 

CPX 

SBC 



CPX 

SBC 

INC 


INX 

SBC 

NOP 


CPX 

SBC 

INC 


E 


imm 

ind, X 



zpg 

zpg 

zpg 



imm 



abs 

abs 

abs 



F 

BEQ 

SBC 

SBC* t 



SBC 

INC 


SED 

SBC 

PLX* 



SBC 

INC 


F 


rel 

ind, Y 

(zpg) 



zpg, X 

zpg, X 



abs, Y 




abs, X 

abs, X 




0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 



Note: * = New OP Codes 
Note: t = New Address Modes 
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> OPERATIONAL CODES, EXECUTION TIME, AND MEMORY 
REQUIREMENTS 



Notes: 


Add 1 to "n" if page boundary is crossed. 

X 

Index X 

+ Add 

n 

No. Cycles 

Add 1 to "n" if branch occurs to same page. 

Y 

Index Y 

— Subtract 

# 

No. Bytes 

Add 2 to "n” if branch occurs to different page. 

A 

Accumulator 

A And 

Mg 

Memory bit 6 

Add 1 to "n” if decimal mode. 

V bit equals memory bit 6 prior to execution. 

N bit equals memory bit 7 prior to execution. 

M 

Ms 

Memory per effective address 
Memory per stack pointer 

V Or 

•V- Exclusive or 

m 7 

Memory bit 7 


*5. The immediate addressing mode of the BIT instruction leaves bits 6 & 7 
(V & N) in the Processor Status Code Register unchanged. 


292 


Appendix A: The 65C02 Microprocessor 


Appendix B 


Memory Map 
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This appendix lists all important RAM and hardware locations in address 
order and briefly describes them. It also provides cross-references to the 
section of the manual where they are described further. Appendix C 
contains a similar list for important firmware addresses. 

The tables in this appendix list addresses in either two or three forms: the 
hexadecimal form (preceded by a dollar sign) for use in assembly language; 
the decimal form for use in Applesoft BASIC; and (for numbers greater than 
32767) the complementary decimal value for use in Apple Integer BASIC. 


B.1 Page $00 


Table B-l lists the zero page addresses in hexadecimal and decimal form, 
followed by symbols denoting the firmware or system software that uses 
them. 

n M denotes the Monitor. 

□ A denotes Applesoft BASIC. 

□ I denotes Integer BASIC. 

□ D denotes DOS 3.3. 

□ P denotes ProDOS. Locations whose contents ProDOS saves and restores 
afterward have a P in parentheses, indicating that ProDOS has no net 
effect on them. 


TablelM. Page $00 Use 


Hex 

Dec 

Used by 

Hex 

Dec 

Used by 

$00 

0 

A 

$10 

16 

A 

$01 

1 

A 

$11 

17 

A 

$02 

2 

A 

$12 

18 

A 

$03 

3 

A 

$13 

19 

A 

$04 

4 

A 

$14 

20 

A 

$05 

5 

A 

$15 

21 

A 

$06 

6 


$16 

22 

A 

$07 

7 


$17 

23 

A 

$08 

8 


$18 

24 

A 

$09 

$0A 

9 

10 

A 

$19 

$1A 

25 

26 


$0B 

11 

A 

$1B 

27 


$0C 

12 

A 

SIC 

28 


$0D 

13 

A 

SID 

29 


$0E 

14 

A 

S1E 

30 


$0F 

15 

A 

S1F 

31 
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TableB-1 — continued. Page $00 Use 


Hex 

Dec 

Used by 


Hex 

Dec 

Used by 


$20 

32 

M 


$48 

72 

M 

D (P) 

$21 

33 

M 


$49 

73 

M 

(P) 

$22 

34 

M 


$4A 

74 

I 

D (P) 

$23 

35 

M 


$4B 

75 

I 

D (P) 

$24 

36 

M 


$4C 

76 

1 

D (P) 

$25 

37 

M 


$4D 

77 

I 

D (P) 

$26 

38 

M 

D 

$4E 

78 

M 

(P) 

$27 

39 

M 

D 

$4F 

79 

M 


$28 

40 

M 

D 





$29 

41 

M 

D 

$50 

80 

M A 


$2A 

42 

M 

D 

$51 

81 

M A 


$2B 

43 

M 

D 

$52 

82 

M A 


$2C 

44 

M 

D 

$53 

83 

M A 


$2D 

45 ’ 

M 

D 

$54 

84 

M A 


$2E 

46 

M 

D 

$55 

85 

M A I 


$2F 

47 

M 

D 

$56 

86 

A I 






$57 

87 

A I 


$30 

48 

M 


$58 

88 

A I 


$31 

49 

M 


$59 

89 

A I 


$32 

50 

M 


$5A 

90 

A I 


$33 

51 

M 


$5B 

91 

A I 


$34 

52 

M 


$5C 

92 

A I 


$35 

53 

M 

D 

$5D 

93 

A I 


$36 

54 

M 

D 

$5E 

94 

A I 


$37 

55 

M 

D 

$5F 

95 

A I 


$38 

56 

M 

D 





$39 

57 

M 

D 

$60 

96 

A I 


$3A 

58 

M 

P 

$61 

97 

A I 


$3B 

59 

M 

P 

$62 

98 

A I 


$3G 

60 

M 

P 

$63 

99 

A I 


$3D 

61 

M 

P 

$64 

100 

A I 


$3E 

62 

M 

D P 

$65 

101 

A I 


$3F 

63 

M 

D P 

$66 

102 

A I 






$67 

103 

A I 

D 

$40 

64 

M 

D (P) 

$68 

104 

A I 

D 

$41 

65 

M 

D (P) 

$69 

105 

A I 

D 

$42 

66 

M 

D (P) 

$6A 

106 

A I 

D 

$43 

67 

M 

D (P) 

$6B 

107 

A I 


$44 

68 

M 

D (P) 

$6C 

108 

A I 


$45 

69 

M 

D (P) 

$6D 

109 

A I 


$46 

70 

M 

D (P) 

$6E 

110 

A I 


$47 

71 

M 

D (P) 

$6F 

111 

A I 

D 
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Table B-l — continued. Page $00 Use 


Hex 

Dec 

Used by 

$70 

112 

A I D 

$71 

113 

A I 

$72 

114 

A I 

$73 

115 

A I 

$74 

116 

A I 

$75 

117 

A I 

$76 

118 

A I 

$77 

119 

A I 

$78 

120 

A I 

$79 

121 

A I 

$7A 

122 

A I 

$7B 

123 

A I 

$7C 

124 

A I 

$7D 

125 

A I 

$7E 

126 

A I 

$7F 

127 

A I 

$80 

128 

A I 

$81 

129 

A I 

$82 

130 

A I 

$83 

131 

A I 

$84 

132 

A I 

$85 

133 

A I 

$86 

134 

A I 

$87 

135 

A I 

$88 

136 

A I 

$89 

137 

A I 

$8A 

138 

A I 

$8B 

139 

A I 

$8C 

140 

A I 

$8D 

141 

A I 

$8E 

142 

A I 

$8F 

143 

A I 

$90 

144 

A I 

$91 

145 

A I 

$92 

146 

A I 

$93 

147 

A I 

$94 

148 

A I 

$95 

149 

A 1 

$96 

150 

A I 

$97 

151 

A I 


Hex 

Dec 

Used by 

$98 

152 

A I 

$99 

153 

A I 

$9A 

154 

A I 

$9B 

155 

A I 

$9C 

156 

A I 

$9D 

157 

A I 

$9E 

158 

A 1 

$9F 

159 

A I 

$A0 

160 

A I 

$A1 

161 

A 1 

$A2 

162 

A I 

$A3 

163 

A I 

$A4 

164 

A I 

$A5 

165 

A I 

$A6 

166 

A I 

$A7 

167 

A I 

$A8 

168 

A I 

$A9 

169 

A 1 

$AA 

170 

A I 

$AB 

171 

A I 

$AC 

172 

A I 

$AD 

173 

A I 

$AE 

174 

A I 

$AF 

175 

A I D 

$B0 

176 

A I D 

$B1 

177 

A I 

$B2 

178 

A I 

$B3 

179 

A I 

$B4 

180 

A I 

$B5 

181 

A I 

$B6 

182 

A 1 

$B7 

183 

A I 

$B8 

184 

A I 

$B9 

185 

A I 

$BA 

186 

A I 

$BB 

187 

A I 

$BC 

188 

A I 

$BD 

189 

A I 

$BE 

190 

A 1 

$BF 

191 

A I 
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Table B-l — continued. Page $00 Use 


Hex 

Dec 

Used by 


Hex 

Dec 

Used by 

$00 

192 

A I 


$E0 

224 

A 

SCI 

193 

A I 


$E1 

225 

A 

$C2 

194 

A I 


IE2 

226 

A 

$C3 

195 

A 1 


IE3 

227 


$C4 

196 

A I 


$E4 

228 

A 

$C5 

197 

A I 


IE5 

229 

A 

$C6 

198 

A I 


IE6 

230 

A 

$C7 

199 

A I 


IE7 

231 

A 

$C8 

200 

A I 


IE8 

232 

A 

$C9 

201 

A I 


$E9 

233 

A 

$CA 

202 

A 1 

D 

$EA 

234 

A 

$CB 

203 

A I 

D 

$EB 

235 


$CC 

204 

A I 

D 

IEC 

236 


$CD 

205 

A I 

D 

$ED 

237 


$CE 

206 

I 


$EE 

238 


$CF 

207 

I 


$EF 

239 


$D0 

208 

A 1 


$F0 

240 

A 

SD1 

209 

A I 


$F1 

241 

A 

$D2 

210 

A I 


IF2 

242 

A 

$D3 

211 

A I 


IF3 

243 

A 

$D4 

212 

A I 


$F4 

244 

A 

$D5 

213 

A I 


IF5 

245 

A 

$D6 

214 

I 


IF6 

246 

A 

$D7 

215 

I 


IF7 

247 

A 

$D8 

216 

A I 

D 

$F8 

248 

A 

$D9 

217 

A 1 


$F9 

249 


IDA 

218 

A I 


$FA 

250 


$DB 

219 

A I 


$FB 

251 


$DC 

220 

A I 


$FC 

252 


$DD 

221 

A I 


$FD 

253 


IDE 

222 

A I 


IFE 

254 


IDF 

223 

A I 


IFF 

255 
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B.2 Page $03 


Most of page $03 is available for small machine-language programs. The 
built-in Monitor uses the top 16 addresses of page $03, as shown in 
Figure B-2; the XFer routine (Section 2.5.3) uses locations $03ED and 
$03EE. If you are using DOS or ProDOS, it also uses the 32 locations $03D0 
through $03EF. 


Table B-2. Page $03 Use 


Hex 

Dec 

Section 

Use 

$03F0 

1008 

2.6.4 

Address of BRK request handler 

$03F1 

1009 


(normally $59, $FA) 

$03F2 

1010 

2.6.4, 10.1 

Reset vector 

$03F3 

1011 



S03F4 

1012 

2.6.4 

Power-up byte (see text) 

$03F5 

1013 


Jump instruction to Applesoft 

$03F6 

1014 


&-command handler 

S03F7 

1015 


(initially $4C, $58, $FF) 

$03F8 

1016 

10.6.4 

Jump instruction to user CONTROL-Y 

$03F9 

1017 


command handler 

$03FA 

1018 



$03FB 

1019 


Jump instruction to NMI interrupt 

$03FC 

1020 


handler (not used by Apple lie) 

$03FD 

1021 



$03FE 

1022 

2.6.4 

Address of user IRQ interrupt handler 

$03FF 

1023 




B.3 Screen Holes 


One result of the way the Apple lie hardware maps display memory on the 
screen is that groups of 8 memory addresses are left over in 16 areas of the 
text and low-resolution display pages— 8 areas in main RAM and 8 in 
auxiliary RAM. The firmware uses for these 128 bytes are shown in 
Tables B-3 and B-4. 
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Table B-3. Main Memory Screen Hole Allocations 


Hex 

Dec 

Section 

$0478 

1144 

9.1.5 

$0479 

1145 

7.5 

$047A 

1146 

8.5 

$047B 

1147 


$047C 

1148 

9.1.5 

$047D 

1149 


$047E 

1150 


$047F 

1151 


$04F8 

1272 

9.1.5 

$04F9 

1273 

7.5, E.6.3 

$04FA 

1274 

8.5, E.6.2 

$04FB 

1275 

$04FC 

1276 

9.1.5 

$04FD 

1277 


$04FE 

1278 


$04FF 

1279 

E.6.4 

$0578 

1400 

9.1.5 

$0579 

1401 

7.5 

$057A 

1402 

8.5 

$057B 

1403 


$057C 

1404 

9.1.5 

$057D 

1405 ‘ 


$057E 

1406 


$057F 

1407 

E.6.4 

$05F8 

1528 

9.1.5 

$05F9 

1529 

7.5, E.6.3 

$05FA 

1530 

8.5, E.6.2 

$05FB 

1531 

$05FC 

1532 

9.1.5 

$05FD 

1533 


$05FE 

1534 


$05FF 

1535 

E.6.2 


Description 

Mouse port: low byte of clamping 
minimum 

Reserved for serial port 1 
Reserved for serial port 2 
Reserved 

Low byte of X coordinate 
Reserved for mouse port 
Reserved 
Reserved 

Mouse port: low byte of clamping 
maximum 

Reserved for serial port 1 
Reserved for serial port 2 
Reserved 

Low byte of Y coordinate 
Reserved for mouse port 
Reserved 
Reserved 

Mouse port: high byte of clamping 
minimum 

Port 1 printer width (1-255; 

0 = unlimited) 

Port 2 line length (1-255; 

0 = unlimited) 

Cursor horizontal position (80-column 
display) 

High byte of X coordinate 
Reserved for mouse port 
Reserved 
Reserved 

Mouse port: high byte of clamping 
maximum 

Port 1 temporary storage location 
Port 2 temporary storage location 
Reserved 

High byte of Y coordinate 
Reserved for mouse port 
Reserved 
Reserved 
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Table B-3 — continued. Main Memory Screen Hole Allocations 


Hex 

Dec 

Section 

$0678 

1656 


$0679 

1657 

7.5 

$067A 

1658 

8.5 

$067B 

1659 


$067C 

1660 

9.1.5 

$067D 

1661 


$067E 

1662 


$067F 

1663 

E.6.4 

$06F8 

1784 


$06F9 

1785 

7.5 

$06FA 

1786 

8.5 

S06FB 

1787 


$06FC 

1788 

9.1.5 

$06FD 

1789 


$06FE 

1790 


$06FF 

1791 

E.6.2 

$0778 

1912 


$0779 

1913 

7.5 

$077A 

1914 

8.5 

$077B 

1915 


$077C 

1916 

9.1.5, E.6.1 

$077D 

1917 


$077E 

1918 


$077F 

1919 


$07F8 

2040 


$07F9 

2041 

7.5 

$07FA 

2042 

8.5 

$07FB 

2043 


$07FC 

2044 

9.1.5 

$07FD 

2045 


$07FE 

2046 


$07FF 

2047 



Description 

Reserved 

Indicates when port 1 firmware is 
parsing a command 
Indicates when port 2 firmware is 
parsing a command 
Reserved 

Mouse port: reserved 
Reserved for mouse port 
Reserved 
Reserved 

Reserved 

Current port 1 command character 
Current port 2 command character 
Reserved 

Mouse port: reserved 
Reserved for mouse port 
Reserved 
Reserved 

DEVNO: $n0 = current active port 
number x 16 

Port 1 flags for echo and auto line feed 
Port 2 flags for each and auto line feed 
Reserved 

Mouse port status byte 
Reserved for mouse port 
Reserved 
Reserved 

MSLOT: owner of $C800-$CFFF ($C3, 
video) 

Port 1 current printer column 
Port 2 current line position 
Reserved 

Mouse port mode byte 
Reserved for mouse port 
Reserved 
Reserved 
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Table B-4. Auxiliary Memory Screen Hole Allocations 


Hex 

Dec 

Section 

Description 

$0478 

1144 

7.5 

Initial port 1 ACIA control register 
values ($9E) 

$0479 

1145 

7.5 

Initial port 1 ACIA command register 
values (SOB) 

$047A 

1146 

7.5 

Initial port 1 characteristics flags ($40) 

$047B 

1147 

7.5 

Initial port 1 printer width ($50) 

$047C 

1148 

8.5 

Initial port 2 ACIA control register 
values ($16) 

$047D 

1149 

8.5 

Initial port 2 ACIA command register 
values (SOB) 

$047E 

1150 

8.5 

Initial port 2 characteristics flags ($01) 

$047F 

1151 

8.5 

Initial port 2 line length ($00) 

$04F8 

through 

1272 


Reserved 

$04FF 

1279 



$0578 

1400 



through 

$057F 

1407 


Reserved 

$05F8 

through 

1528 


Reserved 

$05FF 

1535 



$0678 

through 

1656 


Reserved 

$067F 

1663 



$06F8 

1784 



through 

$06FF 

1791 


Reserved 

$0778 

through 

1912 


Reserved 

$077F 

1919 



$07F8 

2040 



through 

$07FF 

2047 


Reserved 
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B.4 The Hardware Page 


Tables B-5 through B-9 list all the hardware locations available for use in 
the Apple lie. These tables have a column at the left that is not present in 
other tables. This column, labeled indicates the action to take at a 
particular location. 

□ R means read. 

□ RR means read twice in succession. 

□ R7 means read the byte and then check bit 7 ; in the use column, see if... 
refers to the condition represented by bit 7 = 1, unless otherwise 
specified. Bit 7 has a value of $80, so if the contents of the location are 
greater than or equal to $80, the bit is on. 

Another way to test bit 7 (the sign bit) is with a BIT instruction, followed 
by BPL (bit 7 was 0) or BMI (bit 7 was 1). 

□ R/W means to either read or write. For writing, the value is unimportant. 

□ W means to write only. The value is unimportant. 

□ N means not to read or write, because the location is reserved. 

An address of the form $C00x refers to the 16 locations from $C000 through 
$C00F. Labels, when they are shown, are simply memory aids. Some of 
them correspond to the labels at those addresses in the firmware, others do 
not. Your program will have to assign a label for it anyway. 
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Table B-5. Addresses $C000-$C03F 


RW 

Hex 

Dec 

Neg Dec 

Label 

Section 

Use 

R 

$C00x 



KStrb 

4.1 

Read keyboard data (bits 0-6) and strobe (bit 7) 

W 

$C000 

49152 

-16384 

80Store 

2.5.4, 5.6 

Off: Page2 switches Page 1 and 2 

W 

$C001 

49153 

-16383 

80Store 

2.5.4, 5.6 

On: Page2 switches Page 1 and IX 

w 

$C002 

49154 

-16382 

RAMRd 

2.5.2 

Off: Read main 48K RAM 

w 

$C004 

49156 

-16380 

RAMWrt 

2.5.2 

Off: Write in main 48K RAM 

w 

$C005 

49157 

-16379 

RAMWrt 

2.5.2 

On: Write in auxiliary 48K RAM 

w 

$C006 

49158 

-16378 



Reserved 

w 

$C007 

49159 

-16377 



Reserved 

w 

$C008 

49160 

-16376 

AltZP 

2.4.2 

Off: Use main P0, PI, bank-switched RAM 

w 

$C009 

49161 

-16375 

AltZP 

2.4.2 

On: Use auxiliary P0, PI, bank-switched RAM 

w 

$C00A 

49162 

-16374 



Reserved 

w 

$C00B 

49163 

-16373 



Reserved 

w 

SCOOC 

49164 

-16372 

80Col 

5.6 

Off: 40-column display 

w 

$C00D 

49165 

-16371 

80Col 

5.6 

On: 80-column display 

w 

SCOOE 

49166 

-16270 

AltChar 

5.6 

Off: Display primary character set 

w 

SCOOF 

49167 

-16369 

AltChar 

5.6 

On: Display alternate character set 

w 

$C01x 




4.1 

Clear keyboard strobe ($C00x bit 7) 

R7 

$C010 

49168 

-16368 

AKD 

4.1 

See if any key now down; clear strobe 

R7 

$0011 

49169 

-16367 

RdBnk2 

2.4.2 

See if using $D000 bank 2 (or 1) 

R7 

$C012 

49170 

-16366 

RdLCRAM 

2.4.2 

See if reading RAM (or ROM) 

R7 

$C013 

49171 

-16365 

RdRAMRd 

2.5.2 

See if reading auxiliary 48K RAM (or main) 

R7 

$C014 

49172 

-16364 

RdRAMWrt 

2.5.2 

See if writing auxiliary 48K RAM (or main) 

R 

$C015 

49173 

-16363 

RstXInt 

9.1.3 

Reset mouse X0 interrupt 

R7 

SCO 16 

49174 

-16362 

RdAltZP 

2.4.2 

See if auxiliary P0, PI and bank-switched RAM 

R 

SC017 

49175 

-16361 

RstYInt 

9.1.3 

Reset mouse Y interrupt 

R7 

SC018 

49176 

-16360 

Rd80Store 

2.5.4, 5.6 

See if 80Store on (or off) 

R7 

SC019 

49177 

-16359 

RstVBl 

9.1.3 

See if VBlInt off (1); reset it 

R7 

SC01A 

49178 

-16358 

RdTEXT 

5.6 

See if text (or graphics) 

R7 

SC01B 

49179 

-16357 

RdMIXED 

5.6 

See if mixed mode switch on 

R7 

SC01C 

49180 

-16356 

RdPage2 

2.5.4, 5.6 

See if Page 2/1X selected (or 1) 

R7 

SC01D 

49181 

-16355 

RdHiRes 

2.5.4, 5.6 

See if high-resolution switch on 

R7 

SC01E 

49182 

-16354 

RdAltChar 

5.6 

See if alternate character set (or primary) 

R7 

SC01F 

49183 

-16353 

Rd80Col 

5.6 

See if 80-column hardware on 

N 

SC020 

through 

49184 

-16352 



Reserved (read and write) 

N 

SC02F 

49199 

-16337 




W 

SC030 

49200 

-16336 

Reserved 



R 

SC030 

49200 

-16336 


4.2.1 

Toggle speaker 

N 

SC031 

through 

49201 

-16335 



Reserved (read and write) 

N 

SC03F 

49215 

-16321 
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Table B-6. Addresses $C040-$C05F 


RW 

Hex 

Dec 

Neg Dec 

Label 

Section 

Use 

R7 

$C040 

49216 

-16320 

RdXYMsk 

9.1.3 

See if X0/Y0 mask set 

R7 

$C041 

49217 

-16319 

RdVBIMsk 

9.1.3 

See if VB1 mask set 

R7 

$C042 

49218 

-16318 

RdXOEdge 

9.1.3 

See if interrupt on falling X0 edge 

R7 

$C043 

49219 

-16317 

RdYOEdge 

9.1.3 

See if interrupt on falling YO edge 

N 

$C044 

49220 

-16316 



Reserved 

N 

SC045 

49221 

-16315 



Reserved 

N 

$C046 

49222 

-16314 



Reserved 

N 

$C047 

49223 

-16313 



Reserved 

R 

$C048 

49224 

-16312 

RstXY 

9.1.3 

Reset XO/YO interrupt flags 

N 

$C049 

49225 

-16311 



Reserved 

N 

$C04A 

49226 

-16310 



Reserved 

N 

$C04B 

49227 

-16309 



Reserved 

N 

$C04C 

49228 

-16308 



Reserved 

N 

$C04D 

49229 

-16307 



Reserved 

N 

$C04E 

49230 

-16306 



Reserved 

N 

$C04F 

49231 

-16305 



Reserved 

R/W 

$C050 

49232 

-16304 

TEXT 

5.6 

Off: Graphics display 

R/W 

$C051 

49233 

-16303 

TEXT 

5.6 

On: Text display 

R/W 

$C052 

49234 

-16302 

MIXED 

5.6 

Off: Text or graphics only 

R/W 

$C053 

49235 

-16301 

MIXED 

5.6 

On: Combination text and graphics 

R/W 

$C054 

49236 

-16300 

Page2 

2.5.4, 5.6 

Off: Use Page 1 

R/W 

$C055 

49237 

-16299 

Page2 

2.5.4, 5.6 

On: Display Page 2 (80Store off); store to Page 







IX (80Store on) 

R/W 

$C056 

49238 

-16298 

HiRes 

2.5.4, 5.6 

Off: Low-resolution 

R/W 

$C057 

49239 

-16297 

HiRes 

2.5.4, 5.6 

On: High-resolution; double if 80Col and DHiRes 

N 

$C058 

49240 

-16296 



on 

Reserved if IOUDis on ($C07E bit 7=1) 

R/W 




DisXY 

9.1.3 

Disable (mask) mouse X0/Y0 interrupts 

N 

$C059 

49241 

-16295 



Reserved if IOUDis on 

R/W 




EnbXY 

9.1.3 

Enable (allow) mouse X0/Y0 interrupts 

N 

$C05A 

49242 

-16294 



Reserved if IOUDis on 

R/W 




DisVBl 

9.1.3 

Disable (mask) VBL interrupts 

N 

$C05B 

49243 

-16293 



Reserved if IOUDis on 

R/W 




EnVBl 

9.1.3 

Enable (allow) VBL interrupts 

N 

$C05C 

49244 

-16292 



Reserved if IOUDis on 

R/W 




XOEdge 

9.1.3 

Interrupt on rising edge of X0 

N 

$C05D 

49245 

-16291 



Reserved if IOUDis on 

R/W 




XOEdge 

9.1.3 

Interrupt on falling edge of X0 

R/W 

$C05E 

49246 

-16290 

DHiRes 

5.6 

If IOUDis on: Set double-high-resolution 

R/W 




YOEdge 

9.1.3 

If IOUDis off: Interrupt on rising Y0 

R/W 

$C05F 

49247 

-16289 

DHiRes 

5.6 

If IOUDis on: Clear double-high-resolution 

R/W 




YOEdge 

9.1.3 

If IOUDis off: Interrupt on falling Y0 
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Table B-7. Addresses $C060-$C07F 


RW 

Hex 

Dec 

Neg Dec 

Label 

Section 

Use 

W 

$C06x 





Reserved (write) 

R7 

$C060 

49248 

-16288 

Rd80Sw 

4.1 

See if 80/40 switch down (= 40) 

R7 

$C061 

49249 

-16287 

RdBtnO 

4.1, 9.1.3 

See if mouse button/QJ] pressed 

R7 

$C062 

49250 

-16286 

RdBtnl 

4.1, 9.2 

See if switch 1/fi] pressed 

R7 

$C063 

49251 

-16285 

Rd63 

9.1, 9.2 

See if mouse button not pressed 

R7 

$C064 

49252 

-16284 

PdlO 

9.2 

See if hand control button 0 pressed 

R7 

$C065 

49253 

-16283 

Pdll 

9.2 

See if hand control button 1 pressed 

R7 

$C066 

49254 

-16282 

MouXl 

9.1.3 

See if mouse XI (direction) is high 

R7 

$C067 

49255 

-16281 

MouYl 

9.1.3 

See if mouse Y1 (direction) is high 

N 

$C068 

through 

49256 

-16280 



Reserved (write and read) 

N 

SC06F 

49263 

-16273 




R/W 

$C07x 





Trigger paddle timer; reset VBlInt; however, 
some $C07x are reserved 

R/W 

$C070 

49264 

-16272 

PTrig 

9.2 

Designated trigger or reset location 

N 

$C071 

through 

49265 

-16271 



Reserved 

N 

$C07D 

49277 

-16259 




R7 

$C07E 

49278 

-16258 

RdlOUDis 


See if IOUDis on; trigger paddle timer; reset 
VBlInt 

W 




IOUDis 

5.6, 9.1.3 

On: Enable access to DHiRes switch; disable 
$C058-$C05F IOU access 

R7 

$C07F 

49279 

-16257 

RdDHiRes 

5.6, 9.1.3 

See if DHiRes on 

W 




IOUDis 

5.6 

Off: Disable access to DHiRes switch; enable 


$C058-$C05F IOU access 
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Table B-8. Addresses $C080-$C0AF 


RW 

Hex 

Dec 

Neg Dec Label 

Section 

Use 

R 

$C080 

49280 

-16256 

2.4.2 

Read RAM; no write; use $D000 bank 2 

RR 

$C081 

49281 

-16255 

2.4.2 

Read ROM, write RAM; use $D000 bank 2 

R 

$C082 

49282 

-16254 

2.4.2 

Read ROM; no write; use $D000 bank 2 

RR 

$C083 

49283 

-16253 

2.4.2 

Read and write RAM; use $D000 bank 2 

N 

$C084 

49284 

-16252 


Reserved 

N 

$C085 

49285 

-16251 


Reserved 

N 

$C086 

49286 

-16250 


Reserved 

N 

$C087 

49287 

-16249 


Reserved 

R 

$0088 

49288 

-16248 

2.4.2 

Read RAM; no write; use $D000 bank 1 

RR 

$0089 

49289 

-16247 

2.4.2 

Read ROM, write RAM; use $D000 bank 1 

R 

$C08A 

49290 

-16246 

2.4.2 

Read ROM; no write; use $D000 bank 1 

RR 

$C08B 

49291 

-16245 

2.4.2 

Read and write RAM; use $D000 bank 1 

N 

$0080 

49292 

-16244 


Reserved 

N 

$C08D 

49293 

-16243 


Reserved 

N 

$C08E 

49294 

-16242 


Reserved 

N 

$C08F 

49295 

-16241 


Reserved 

N 

$0090 

through 

49296 

-16240 


Reserved 

N 

$0097 

49303 

-16233 



R/W 

$0098 

49304 

-16232 

7.3, 11.11 

Port 1 ACIA transmit/receive register 

R/W 

$0099 

49305 

-16231 

7.3, 11.11 

Port 1 ACIA status register 

R/W 

$C09A 

49306 

-16230 

7.3,11.11, 

E 

7.3,11.11 

Port 1 ACIA command register 

R/W 

$C09B 

49307 

-16229 

Port 1 ACIA control register 

N 

$0090 

through 

49308 

-16228 


Reserved 

N 

$C09F 

49311 

-16225 



N 

$C0A0 

through 

49312 

-16224 


Reserved 

N 

$C0A7 

49319 

-16217 



R/W 

$C0A8 

49320 

-16216 

8.3, 11.11 

Port 2 ACIA transmit/receive register 

R/W 

$C0A9 

49321 

-16215 

8.3,11.11 

Port 2 ACIA status register 

R/W 

$C0AA 

49322 

-16214 

8.3, 11.11, 

E 

8.3,11.11 

Port 2 ACIA command register 

R/W 

$C0AB 

49323 

-16213 

Port 2 ACIA control register 

N 

$C0AC 

through 

49324 

-16212 


Reserved 

N 

$C0AF 

49327 

-16209 
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Table B-9. Addresses $COBO-$COFF 


RW 

Hex 

Dec 

Neg Dec 

N 

$C0B0 

49328 

-16208 

N 

through 

$C0BF 

49343 

-16193 

N 

$C0C0 

49344 

-16192 

N 

through 

$C0CF 

49359 

-16177 

N 

$C0D0 

49360 

-16176 

N 

through 

$C0DF 

49375 

-16161 

N 

$C0E0 

49376 

-16160 

N 

through 

$C0EF 

49391 

-16145 

N 

$C0F0 

49392 

-16144 

N 

through 

SCOFF 

49407 

-16129 


Label Section Use 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 


B.4 The Hardware Page 


307 



Appendix C 


Important Firmware Locations 



309 


▲Warning 

This appendix lists all significant firmware addresses: entry points, 
locations containing the addresses of entry points, and locations where 
machine and device identification bytes reside. 

The Monitor firmware entry points are the only published entry points 
in the sense that they are the only ones that will remain in the same 
locations in future Apple II series computers. 

The firmware protocol identification bytes and offsets will work with 
other Apple II series computers only if used as directed (Section 3.4.2). 

C.1 The Tables 

1 

i 

i 

i 

1 

i 

1 

i 

1 

] 

] 

] 

< 

This appendix supplements the chapter text by specifying three forms of 
each address: hexadecimal, decimal, and complementary (negative) 
decimal. 

In these tables, some of the addresses are followed by a label. These labels 
are listed only to help you find the named location in the firmware listings, 
or to remember the function found at the address. The Apple lie contains no 
global label table: your program must assign its own labels to the addresses 
as required. 

There are several types of information at these firmware addresses: actual 
entry points (labeled entry), the low-order byte of an entry point (labeled 
offset), a device or machine identification byte (labeled ident), indicators 
(labeled indie) specifying whether there are optional routines, vector 
addresses (labeled vector), or an RTS instruction location. 

The column labeled Section contains the number of the section that 
describes the item. If there is no description except in a table in this 
appendix, a section number is not listed. 

Each input/output port has an associated protocol table, as shown in 

Tables C-l through C-4. Many of the bytes (labeled offset) in the protocol 
tables are the low-order bytes of addresses of I/O routines for the ports; the 
tiigh-order byte of these addresses must be $Cn (where n is the port 
cumber). This structure is explained in Chapter 3. Although your program 
must perform some extra processing to use these tables, the benefit is 
simplified compatible port and slot I/O for all Apple II series machines. 
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C.2 Port Addresses 


Addresses for serial ports 1 and 2, output port 3, and mouse input port 4 are 
shown in the following four tables. 


Table C-l. Serial Port 1 Addresses 


Hex 

Dec 

Neg Dec Label 

Type 

Section 

Description 

$C100 

49408 

-16128 

entry 

3.1.1 

Main port 1 entry point 

$C105 

49413 

-16123 

ident 

3.4.2 

ID byte ($38) 

$C107 

49415 

-16121 

ident 

3.4.2 

ID byte ($18) 

$C10B 

49419 

-16117 

ident 

3.4.2 

Firmware card signature ($01) 

$C10C 

49420 

-16116 

ident 

3.4.2 

Super Serial Card ID ($31) 

$C10D 

49421 

-16115 

offset 

7.4 

Low-order PInit address 

$C10E 

49422 

-16114 

offset 

7.4 

Low-order PRead address 

$C10F 

49423 

-16113 

offset 

7.4 

Low-order PWrite address 

$C110 

49424 

-16112 

offset 

7.4 

Low-order PStatus address 

$C111 

49425 

-16111 

indie 

3.4.2 

Non-zero: no optional routines 


Table C-2. Serial Port 2 Addresses 


Hex 

Dec 

Neg Dec Label 

Type 

Section 

Description 

$C200 

49664 

-15872 

entry 

3.1.1 

Main port 2 entry point 

$C205 

49669 

-15867 

ident 

3.4.2 

ID byte ($38) 

$C207 

49671 

-15865 

ident 

3.4.2 

ID byte ($18) 

$C20B 

49675 

-15861 

ident 

3.4.2 

Firmware card ID ($01) 

$C20C 

49676 

-15860 

ident 

3.4.2 

Super Serial Card ID ($31) 

$C20D 

49677 

-15859 

offset 

8.4 

Low-order PInit address 

$C20E 

49678 

-15858 

offset 

8.4 

Low-order PRead address 

$C20F 

49679 

-15857 

offset 

8.4 

Low-order PWrite address 

$C210 

49680 

-15856 

offset 

8.4 

Low-order PStatus address 

$C211 

49681 

-15855 

indie 

3.4.2 

Non-zero: no optional routines 
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Table C-3. Video Firmware Addresses 


Hex 

Dec 

Neg Dec 

Label 

Type 

Section 

Description 

$C300 

49920 

-15616 


entry 

3.1.1 

Main video entry point (output only) 

$C305 

49925 

-15611 

C3KeyIn 

ident 

3.4.2 

ID byte ($38) 

$C307 

49927 

-15609 

C3COutl 

ident 

3.4.2 

ID byte ($18) 

$C30B 

49931 

-15605 


ident 

3.4.2 

Firmware card signature ($01) 

$C30C 

49932 

-15604 


ident 

3.4.2 

80-column card ID ($88) 

$C30D 

49933 

-15603 


offset 

5.9 

Low-order PInit address 

$C30E 

49934 

-15602 


offset 

5.9 

Low-order PRead address 

$C30F 

49935 

-15601 


offset 

5.9 

Low-order PWrite address 

$0310 

49936 

-15600 


offset 

5.9 

Low-order PStatus address 

$0311 

49937 

-15599 

MoveAux 

entry 

2.5.3 

Routine for main/auxiliary control 
swapping (also called AuxMove) 


Table C-4. Mouse Port Addresses 


Hex 

Dec 

Neg Dec 

Label 

Type 

Section 

Description 

$C400 

50176 

-15360 


entry 


Main mouse entry point 

$C405 

50181 

-15355 


ident 

3.4.2 

ID byte ($38) 

$C407 

50183 

-15353 


ident 

3.4.2 

ID byte ($18) 

$C40B 

50187 

-15349 


ident 

3.4.2 

Firmware card signature ($01) 

$C40C 

50188 

-15348 


type 

3.4.2 

X-Y pointing device ID ($20) 

$C40D 

50189 

-15347 


offset 

9.1.4 

Low-order PInit address 

$C40E 

50190 

-15346 


offset 

9.1.4 

Low-order PRead address 

$C40F 

50191 

-15345 


offset 

9.1.4 

Low-order PWrite address 

$C410 

50192 

-15344 


offset 

9.1.4 

Low-order PStatus address 

$C411 

50193 

-15343 


indie 

3.4.2 

Optional routines follow ($00) 

$C412 

50194 

-15342 

SetMouse 

offset 

9.1.4 

Low-order SetMouse address 

$C413 

50195 

-15341 

ServeMouse 

offset 

9.1.4 

Low-order ServeMouse address 

$C414 

50196 

-15340 

ReadMouse 

offset 

9.1.4 

Low-order ReadMouse address 

$C415 

50197 

-15339 

ClearMouse 

offset 

9.1.4 

Low-order ClearMouse address 

$C416 

50198 

-15338 

PosMouse 

offset 

9.1.4 

Low-order PosMouse address 

$C417 

50199 

-15337 

ClampMouse 

offset 

9.1.4 

Low-order ClampMouse address 

$C418 

50200 

-15336 

HomeMouse 

offset 

9.1.4 

Low-order HomeMouse address 

$C419 

50201 

-15335 

InitMouse 

offset 

9.1.4 

Low-order InitMouse address 
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C.3 Other Video and I/O Firmware Addresses 


Miscellaneous firmware addresses are listed in Table C-5. 


Table C-5. Apple lie Enhanced Video and Miscellaneous Firmware 


Hex 

Dec 

Neg Dec 

Label 

Type 

Section 

Description 

$C600 

50688 

-14848 


entry 

6.1 

Disk drive firmware entry point 

$C700 

50944 

-14592 


entry 

6.2 

External disk startup routine 

$C803 

51203 

-14333 

NewIRQ 

entry 

E.l 

IRQ handling routine 


C.4 Applesoft BASIC Interpreter Addresses 


The addresses of Applesoft BASIC entry points are listed in the Applesoft 
BASIC Programmer’s Reference Manual. The Applesoft interpreter 
occupies ROM addresses from $D000 through $F7FF. 


C.5 Monitor Addresses 


Table C-6 lists the Monitor entry points, machine identifier bytes, interrupt 
vectors, and the address of a known RTS instruction. 


Table C-6. Apple lie Monitor Entry Points and Vectors 


Hex 

Dec 

Neg Dec 

Label 

Type 

Section 

Description 

$F800 

63488 

-2048 

PLOT 

entry 

5.8 

Plots a low-resolution block 

$F819 

63513 

-2023 

HLine 

entry 

5.8 

Draws low-resolution horizontal line 

$F828 

63528 

-2008 

VLine 

entry 

5.8 

Draws low-resolution vertical line 

$F832 

63538 

-1998 

ClrScr 

entry 

5.8 

Clears low-resolution screen 

$F836 

63542 

-1994 

ClrTop 

entry 

5.8 

Clears top 40 low-resolution lines 

$F864 

63588 

-1948 

SetCol 

entry 

5.8 

Sets low-resolution color (Table 5-4) 

IF871 

63601 

-1935 

SCRN 

entry 

5.8 

Reads color of low-resolution block 

SF941 

63809 

-1727 

PrntAX 

entry 

5.8 

Displays A and X in hex 

$F94A 

63818 

-1718 

PrB12 

entry 

5.8 

Sends X blanks to output 

SFA47 

63845 

-1691 

NewBRK 

entry 

E.2 

Apple lie break handler 

SFA62 

64098 

-1438 

Reset 

entry 

2.6 

Hardware reset routine 
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Table C-6 — continued. Apple lie Monitor Entry Points and Vectors 


Hex 

Dec 

Neg Dec 

Label 

Type 

Section 

Description 

$FB1E 

64386 

-1150 

PRead 

entry 

9.2 

Reads hand controller position 

$FB6F 

64467 

-1169 

SetPwrC 

entry 

2.6.4 

Routine to create power-up byte 

$FBB3 

64635 

-1101 


ident 

F.1.2 

Machine identification byte 

$FBC0 

64548 

-1088 


ident 

F.1.2 

Machine identification byte 

$FBDD 

64477 

-1059 

Belli 

entry 

4.2.2 

Sends 1-kHz beep to speaker 

SFC42 

64578 

-958 

ClrEOP 

entry 

5.8 

Clears from cursor to bottom 

$FC58 

64600 

-936 

HOME 

entry 

5.8 

Clears from cursor to upper left 

$FC9C 

64668 

-868 

ClrEOL 

entry 

5.8 

Clears from cursor to end of line 

$FC9E 

64670 

-866 

C1E0LZ 

entry 

5.8 

Clears from BASL to end of line 

$FCA8 

64680 

-856 

WAIT 

entry 


Delays for time specified by A 

SFDOC 

64780 

-756 

RdKey 

entry 

3.2.1 

Displays cursor, jumps to KSW 

$FD1B 

64795 

-741 

Keyln 

entry 

3.2.2 

Waits for keypress, reads key 

$FD35 

64821 

-715 

RdChar 

entry 

4.1.2 

Gets input, interprets ESC codes 

$FD67 

64871 

-665 

GetLnZ 

entry 

4.1.2 

Sends CR to output, goes to GetLn 

IFD6A 

64874 

-662 

GetLn 

entry 

3.2.3 

Displays prompt, gets input line 

$FD6F 

64879 

-657 

GetLnl 

entry 

4.1.2 

No prompt; gets input line 

$FD8B 

64907 

-629 

CROutl 

entry 

5.8 

Clears to end of line, calls CROut 

$FD8E 

64910 

-626 

CROut 

entry 

5.8 

Sends CR to output 

$FDDA 

64986 

-550 

PrByte 

entry 

5.8 

Sends A to output 

$FDE3 

64995 

-541 

PrHex 

entry 

5.8 

Displays low nibble of A in hex 

$FDED 

65005 

-531 

COut 

entry 

3.3.1 

Jumps to CSW 

$FDF0 

65008 

-528 

COutl 

entry 

3.3.2 

Displays A, advances cursor 

$FE2C 

65068 

-468 

MOVE 

entry 


Copies memory elsewhere 

$FE36 

65078 

-458 

VERIFY 

entry 


Compares two blocks of memory 

$FF2D 

65325 

-211 

PrErr 

entry 

5.8 

Sends ERR to output; beeps 

$FF3A 

65338 

-198 

Bell 

entry 

4.2.2 

Sends CONTROL-G to output 

$FF3F 

65343 

-193 

IORest 

entry 


Loads $45-$49 into registers 

SFF4A 

65354 

-182 

IOSave 

entry 


Stores A, X, Y, P, S at $45-$49 

$FF58 

65368 

-168 

IORTS 

RTS 


Location of known RTS instruction 

$FF69 

65385 

-151 

Monitor 

entry 

10.1 

Standard Monitor entry point 

SFFFA 

65530 

-6 


vector 


Low-order NMI vector (unused) 

$FFFB 

65531 

-5 


vector 


High-order NMI vector (unused) 

$FFFC 

65532 

-4 


vector 


Low-order reset vector ($62) 

SFFFD 

65533 

-3 


vector 


High-order reset vector ($FA) 

$FFFE 

65534 

-2 

IRQVect 

vector 


Low-order IRQ vector ($03) 

$FFFF 

65535 

-1 


vector 


High-order IRQ vector ($CB) 
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This appendix is an overview of the characteristics of operating systems 
and languages when run on the Apple lie. It is not intended to be a complete 
description. For more information, refer to the manuals that are provided 
with each product. 


D.1 Operating Systems 


This section discusses the operating systems that the Apple lie works with. 
CP/M, and any other operating system that requires an interface card, does 
not work on the Apple lie. 


D.1.1 ProDOS 

ProDOS is the preferred disk operating system for the Apple lie. It supports 
startup from the external disk drive (on original Apple lie’s with the 
command PR#7), interrupts, and all other hardware and firmware features 
of the Apple lie. 


D.1 .2 DOS 

The Apple lie works with DOS 3.3. Its built-in disk drive hardware and 
firmware can also access DOS 3.2 disks by using the BASICS disk. DOS 
support is provided for the sake of Apple II series compatibility; neither 
version of DOS takes full advantage of all the features of the Apple lie. 


D.1. 3 Pascal Operating System 

Versions 1.2 and later of the Pascal Operating System use the 80/40 switch 
and the interrupt features of the Apple lie, while remaining compatible with 
the other Apple II series computers. 

While the Apple lie works with Pascal 1.1, this version of the Pascal 
Operating System does not use the 80/40 switch or handle interrupts. 

The Apple lie does not work with Pascal 1.0, because the I/O firmware 
entry points of that version of the operating system are rigidly defined 
(rather than being accessed via a table), and the Apple He’s built-in 
firmware does not correspond to these entry points. 
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D.2 Languages 


This section discusses using Apple programming languages with the 
Apple lie. It is also a guide to using this reference manual with these 
languages. 


D.2.1 Applesoft BASIC 

The programming examples in this manual are almost entirely in assembly 
language, and so most addresses and values are given in hexadecimal 
notation. 

Use a PEEK in BASIC (instead of LDA in assembly language) to read a 
location, and a POKE (instead of STA) to write to a location. The values 
used by Applesoft must be in decimal, so you will have to convert 
hexadecimal values given in this manual to decimal. (Several tables in this 
manual include decimal equivalents to make the job easier for you.) 

If you read a hardware address from a BASIC program, you get a value 
between 0 and 255. Bit 7 has a value of 128, so if a soft switch is on, its 
value will be equal to or greater than 128; if the switch is off, the value will 
be less than 128. 


D.2.2 Integer BASIC 

You will have to run a version of DOS in your Apple lie to use Integer 
BASIC. ProDOS does not support Integer BASIC. 


D.2. 3 Pascal 


The Pascal language runs on the Apple lie under versions 1.1 or later of the 
Pascal Operating System. However, for best performance, use Pascal 
versions 1.2 or later. 


D.2.4 FORTRAN 


FORTRAN runs under version 1.1 of the Pascal Operating System, which, as 
explained in Section D.1.3, does not detect or use certain Apple lie features, 
such as the 80/40 switch or auxiliary memory. Therefore, FORTRAN does 
not take advantage of these features either. 
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D.2.5 Logo II 


Apple Logo II works under ProDOS on Apple II series machines with at least 
128K of memory. Logo II is a version of the Logo language originally 
developed from the LISP (LISt Processing) language at MIT as a language to 
be used for learning. Logo II takes advantage of the Apple IPs graphics and 
retains much of the power and flavor of LISP without LISP’s somewhat 
cryptic syntax. 
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This appendix describes the sources of interrupts on the Apple lie, how the 
firmware handles the interrupts, and how to use interrupt-driven features 
directly in those rare cases when the firmware cannot meet your needs. 


▲Warning 


If you use interrupt hardware directly, instead of using the built-in 
interrupt-handling firmware, you can’t be sure that your programs will be 
compatible with possible future Apple II series computers or revisions. 


E.1 Introduction 


This section describes interrupts and their effects on the Apple lie 
hardware. 


E.1.1 What Is an Interrupt? 

An interrupt is a signal that a computer uses to know when to stop what it’s 
doing so it can quickly handle a time-dependent task. For example, the 
Apple lie mouse sends an interrupt to the computer every time it moves. 
This lets the system keep track of the mouse’s position and maintain 
smooth movement of the pointer on the screen. 

When an interrupt occurs, control passes to an interrupt handler, which 
must record the exact state of the computer at the moment of the interrupt, 
determine the source of the interrupt, and take appropriate action. It is 
important that the computer preserve a snapshot of its state when 
interrupted, so that when it continues later with what it was doing, those 
conditions can be restored. 


E.1. 2 Interrupts on Apple II Computers 

Interrupts have not always been fully supported on the Apple II. All 
versions of Apple’s DOS, as well as the Monitor program, rely on the 
integrity of location $45, which the built-in interrupt handler has always 
destroyed by saving the accumulator in it. Most versions of Pascal simply do 
not work with interrupts enabled. 

The Apple lie built-in interrupt handler now saves the accumulator on the 
stack instead of in location $45. DOS 3.3, ProDOS, Pascal 1.2 (or later 
versions) and the Monitor all work with interrupts on the Apple lie. 
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You should use either ProDOS or Pascal 1.2 (or later versions) if you want 
interrupt-using software to work on the Apple He and the Apple II Plus. 

Both operating systems have full interrupt support built in. 

Interrupts are effective only if they are enabled most of the time since 
interrupts that occur while interrupts are disabled cannot be detected. Due 
to the critical timing of disk read and write operations, Pascal, DOS 3.3, and 
ProDOS turn off interrupts while accessing the disk. Thus it is important to 
remember that while a disk drive is being accessed, all the interrupt sources 
discussed below are turned off. 

On the Apple lie only, interrupts are periodically turned off while 80-column 
screen operations are being performed. This is most noticeable while the 
screen is scrolling. Also, most peripheral cards used in the Apple He disable 
interrupts while reading and writing. 


E.1.3 Interrupt Handling on the 65C02 

From the point of view of the 65C02, there are three possible causes of 
interrupts. 

1. The IRQ line on the microprocessor can be pulled low if 65C02 
interrupts are not masked (that is, the CLI instruction has been used). 
This is the standard technique that devices use when they need 
immediate attention. 

2 . The processor executes a break (BRK, opcode $00) instruction. 

3 . A nonmaskable interrupt (NMI) occurs. Because the NMI line in the 
Apple He’s 65C02 is not used, this never happens on the Apple lie. 

The first two possibilities cause the 65C02 to save the current program 
counter and status byte on the stack and then jump to the routine whose 
address is stored in $FFFE and $FFFF. The sequence performed by the 
65C02 is: 

1. If an IRQ occurs, finish executing the current instruction. (If a BRK 
occurs, the current instruction is already finished.) 

2 . Push the high byte of the program counter onto stack. 

3 . Push the low byte of the program counter onto stack. 

4 . Push the program status byte onto stack. 

5. Jump to the address stored in $FFFE, SFFFF— that is, JMP ($FFFE). 

The different sources of interrupt signals are discussed below. 
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E.1.4 The Interrupt Vector at $FFFE 


In the Apple lie there are three separate regions of memory that contain 
address $FFFE: the built-in ROM, the bank-switched memory in main RAM, 
and the bank-switched memory in auxiliary RAM. The vector at $FFFE in 
the ROM points to Apple lie’s built-in interrupt handling routine. You should 
generally use the built-in interrupt handler, rather than writing your own, 
because of the complexity of interrupts on the Apple lie. 

When you initialize the mouse or serial communication firmware, copies of 
the ROM’s interrupt vector are placed in the interrupt vector addresses in 
both main and auxiliary bank-switched memory. If you plan to use 
interrupts and the bank-switched memory without the mouse or 
communication firmware, you must copy the ROM’s interrupt vector 
yourself. 


E.2 The Built-in Interrupt Handler 


The built-in interrupt handler is responsible for determining whether a BRK 
or an IRQ interrupt occurred. If it was an IRQ interrupt, it decides whether 
the interrupt should be handled internally, handled by the user, or simply 
ignored. 

The built-in interrupt handling routine records the current memory 
configuration, then sets up its own standard memory configuration so that a 
user’s interrupt handler knows the precise memory configuration when it is 
called. 

Next the handler checks to see if the interrupt was caused by a break 
instruction, and if it was, handles it as described in Section E.4. 

If the interrupt was not caused by a BRK, the handler checks for interrupts 
that it knows how to handle (for example, a properly initialized mouse) and 
handles them. 

Depending on the state of the system, it either ignores other interrupts, or 
passes them to a user’s interrupt handling routine whose address is stored 
at $03FE and $03FF of main memory. 

After handling an interrupt itself, or after the user’s handler returns (with 
an RTI), the built-in interrupt handler restores the memory configuration, 
and then does an RTI to restore processing to where it was when the 
interrupt occurred. Figure E-l illustrates this whole process. Each of the 
steps is explained in detail in the sections that follow. 
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Figure E-l. Interrupt-Handling Sequence 


Interrupted Built-in User’s 

Program Processor Handler Handler 

Program ►Push address 

Push status 

JMP ($FFFE) ► Save old and set 
new memory 
configuration. 

If BRK then go to ► 

break handler 

($FA47). 

Our interrupt? 

NO: 

Push address 
Push status 

JMP ($03FE) ► Handle interrupt. 

YES: 

Handle it. 

Restore memory •*- RTI 
configuration. 

Pull status -« RTI 

Program Pull address 


E.2.1 Saving the Memory Configuration 

The built-in interrupt handler saves the state of the system, and sets it to a 
known state according to these rules: 

□ If 80Store and Page2 are on, then it switches in text Page 1 (Page2 off) so 
that main screen holes are accessible. 

□ It switches in main memory for reading (RAMRd off). 

□ It switches in main memory for writing (RAMWrt off). 

□ It switches in ROM addresses $D000-$FFFF for reading (RdLCRAM off). 

□ It switches in main stack and zero page (AltZP off). 

□ It preserves the auxiliary stack pointer, and restores the main stack 
pointer (see Section E.2.2). 

□ It preserves the current ROM state and switches in the ROM bank 1. 


E.2 The Built-In Interrupt Handler 


Note: Because main memory is switched in, all memory addresses used 
later in this appendix are in main memory unless otherwise specified. 


E.2.2 Managing Main and Auxiliary Stacks 

Because the Apple lie has two stack pages, the firmware has established a 
convention that allows the system to be run with two separate stack 
pointers. Two bytes in the auxiliary stack page are to be used as storage for 
inactive stack pointers: $0100 for the main stack pointer when the auxiliary 
stack is active, and $0101 for the auxiliary stack pointer when the main 
stack is active. 

When a program that uses interrupts switches in the auxiliary stack for the 
first time, it should place the value of the main stack pointer at auxiliary 
stack address $0100, and initialize the auxiliary stack pointer to $FF (the 
top of the stack). When it subsequently switches from one stack to the 
other, it should save the current stack pointer before loading the pointer for 
the other stack. 

When an interrupt occurs while the auxiliary stack is switched in, the 
current stack pointer is stored at $0101, and the main stack pointer is 
retrieved from $0100. Then the main stack is switched in for use. After the 
interrupt has been handled, the stack pointer is restored to its original 
value. 


E.3 User’s Interrupt Handler at $03FE 

You can set up screen hole locations to indicate that the user’s interrupt 
handler should be called when certain interrupts occur. To do this, place 
your interrupt handler’s address at $03FE and $03FF in main memory, low 
byte first. 

The user’s interrupt handler should do the following: 

n Verify that the interrupt came from the expected source. The following 
sections describe how this should be done for each interrupt source. 

□ Handle the interrupt as desired. 

□ Clear the interrupt, if necessary. The following sections describe how to 
clear the interrupts. 

□ Return with an RTI. 
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If your interrupt handler needs to know the memory configuration at the 
time of the interrupt, it can check the encoded byte stored four bytes down 
on the stack. This byte is explained in Section E.4. 

In general there is no guaranteed maximum response time for interrupts. 
This is because the system may be doing a disk operation, which could last 
for several seconds. 

Once the built-in interrupt handler has been called, it takes about 250 to 
300 microseconds for it to call your interrupt handling routine. After your 
routine returns, it takes 40 to 140 microseconds to restore memory and 
return to the interrupted program. 

If memory is in the standard state when the interrupt occurs, the total 
overhead for interrupt processing is about 150 microseconds less than if 
memory is in the worst possible state (80Store and Page2 on, auxiliary 
memory switched in for reading and writing, auxiliary bank-switched 
memory page $02 switched in for reading and writing). 


E.4 Handling Break Instructions 


After the interrupt handler has set the memory configuration, it checks to 
see if the interrupt was caused by a BRK (opcode $00) instruction. (If it 
was, bit 4 of the processor status byte is a 1.) If so, it jumps to a break 
handling routine, which saves the state of the computer at the time of the 


break as follows: 

Information Location 

Program counter (low byte) $3A 

Program counter (high byte) $3B 

Encoded memory state $44 

Accumulator $45 

X register $46 

Y register $47 

Status register $48 


Finally, the break routine jumps to the routine whose address is stored at 
$03F0 and $03F1. 

The encoded memory state in location $44 can be interpreted as follows: 
Bit 7 = 0 

Bit 6 =1 if 80Store and Page2 both on 


E.4 Handling Break Instructions 
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Bit 5 

= 1 

if auxiliary RAM switched in for reading 

Bit 4 

= 1 

if auxiliary RAM switched in for writing 

Bit 3 

= 1 

if bank-switched RAM being read 

Bit 2 

= 1 

if bank-switched $D000 page $01 switched in 

Bit 1 

= 1 

if bank-switched $D000 page $02 switched in 

BitO 

= 0 



E.5 Sources of Interrupts 


The Apple lie can receive interrupts from many different sources. Each 
source is enabled and used slightly differently from the others. There are 
two basic sources of interrupts: use of the mouse, and actions affecting the 
two 6551 ACIA circuits (the chips that control serial communication). How 
to use these sources of interrupts in conjunction with the built-in interrupt 
handler is discussed in Section E.6. 

Mouse use can cause interrupts when 

□ -the mouse is moved in the horizontal (X) direction 

□ the mouse is moved in the vertical (Y) direction 

□ the mouse button is pressed. 

Interrupts can also be generated every 1/60 second by the rising edge of the 
vertical blanking signal. This is called the vertical blanking (VBL) interrupt, 
and is synchronized with a signal used for the video display. 

Actions affecting the ACIA circuits can cause interrupts when 

□ a key is pressed (the firmware can use this interrupt to buffer 
keystrokes, or it can pass the interrupt on to the user) 

□ either ACIA has received a byte of data from its port (the firmware can 
use this interrupt to buffer data or it can pass the interrupt on to the 
user) 

□ pin 5 of either serial port changes state (device ready /not ready to accept 
data) (when the serial firmware is active, this interrupt is absorbed; 
however, the serial firmware uses the signal to decide whether or not to 
transmit the next byte of data) 

□ either ACIA is ready to accept another character to be transmitted (when 
the serial firmware is active, this interrupt is absorbed; however, the 
serial firmware uses the signal to decide whether or not to transmit the 
next byte of data) 
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□ the keyboard strobe is cleared (the firmware absorbs this interrupt). 

An interrupt can also be generated by a device attached to the external disk 
drive port. The firmware can pass this interrupt on to the user. 


E.6 Firmware Handling of Interrupts 


The following sections discuss how the various sources of interrupts should 
be used together with the built-in interrupt handler. 


E.6.1 Firmware for Mouse and VBL 


As described in Chapter 9, the mouse can be initialized (by the SetMouse 
call) to nine different modes that enable one or more sources of interrupts. 
In transparent mode, the interrupts are entirely handled by the built-in 
interrupt handler; the other modes require a user-installed interrupt 
handler. 

When the mouse is initialized, the interrupt vector is copied to addresses 
$FFFE and $FFFF in main and auxiliary bank-switched RAM. This permits 
mouse interrupts with any memory configuration. 

When the mouse is active, possible sources of interrupts are those listed in 
Section E.5 as resulting from mouse use. 

When an interrupt occurs, the built-in interrupt handler determines 
whether that particular interrupt source was enabled (by the SetMouse 
call). If so, the user’s interrupt handler, whose address is stored at $03FE, is 
called. 

The user’s interrupt handler should first call ServeMouse to determine the 
source of the interrupt. This call updates the mouse status byte at $077C 
and returns with the carry bit clear if mouse movement, button, or vertical 
blanking was the source of the interrupt. 

The values of this mouse status byte at $077C are as follows: 

Bit 1 means that 

3 Interrupt was from vertical blanking 

2 Interrupt was from button 

1 Interrupt was from mouse movement 


E.6 Firmware Handling of Interrupts 
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If the interrupt was due to mouse movement or button, the user’s interrupt 
handler should then do a call to ReadMouse. This causes the mouse 
coordinates and status to be updated as follows: 

$047 C Low byte of X coordinate 

$04FC Low byte of Y coordinate 

$057C High byte of X coordinate 

$05FC High byte of Y coordinate 

$077C Button and movement status 

Bit Means 

7 0 = button up; 1 = button down 

6 0 = button up on last ReadMouse 

1 = button down on last ReadMouse 
5 0 = no movement since last ReadMouse 

1 = movement since last ReadMouse 

3-1 Always set to 0 (interrupt cleared) 

After the interrupt has been handled, the routine should terminate with 
an RTI. 

Remember that interrupts may be missed during disk accesses. 

If you turn on mouse interrupts without initializing the mouse, the built-in 
interrupt handler will absorb the interrupts. If you want to handle mouse 
interrupts yourself, you must write your own interrupt handler and place 
vectors to it at addresses $FFFE and $FFFF in bank-switched RAM. 
Interrupts will be ignored whenever the $D000-$FFFF ROM is switched in. 


E.6.2 Firmware for Keyboard Interrupts 

The Apple lie hardware is able to generate an interrupt when a key is 
pressed. The firmware is able to buffer up to 128 keystrokes, completely 
transparently, when properly enabled to do so. It saves them in the second 
half of page $08 of auxiliary memory. After the buffer is full, subsequent 
keystrokes are ignored. Because interrupts are only generated when 
keypresses occur, characters generated by the auto-repeat feature are not 
buffered. They can, however, be read when the buffer is empty. 

Once keyboard buffering has been turned on, the next key should be read 
by calling RdKey ($FD0C). 
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▲Warning 


Do not call the buffer reading routine directly. Its entry address will not 
be the same in future versions of the computer. 

The special characters I control if sl (stop list) and | control H~c~ 1 (stop 
Applesoft execution) do not work while keyboard buffering is turned on. A 
new keystroke, |~8~H control H~x1, clears the buffer. 

Using Keyboard Buffering Firmware 

Keyboard buffering is automatically turned on when the serial firmware is 
placed in terminal mode. Otherwise you must turn it on yourself this way: 

1. Disable processor interrupts (SEI). 

2 . Set location $05FA to $80. This tells the firmware to buffer keystrokes 
without calling the user’s interrupt handler. 

3. Set locations $05FF and $06FF to $80. These are pointers to where in 
the buffer the next keystroke will be stored and where the next will be 
read from, respectively. 

4 . Turn on the ACIA for port 2 by setting the low nibble of $C0AA to the 
value $0F. For example: 

lda $C0 aa Read port 2 ACIA command register 

ora #$bf Set low nibble to $0F 

sta $C0AA Set port 2 ACIA command register 

If you are using the serial ports at the same time, just set the low bit of 
$C0AA to 1. This prevents receiver interrupts from being turned off. 

A PR#2 or IN#2 or the equivalent will shut off keyboard interrupts. 

5 . Enable processor interrupts (CLI). 

Using Keyboard Interrupts Through Firmware 

Keyboard interrupts are received through the ACIA for port 2. They can be 
enabled as follows: 

1. Disable processor interrupts (SEI). 

2 . Set location $05FA to $C0. This tells the firmware to identify a 
keystroke interrupt, and to call the user’s interrupt handler. 

3. Turn on the ACIA for port 2 by setting the low nibble of $C0AA to the 
value $0F. For example: 

lda $C 0 AA Read port 2 ACIA command register 

ora #$0F Set low nibble to $0F 

sta $C0AA Set port 2 ACIA command register 

4 . Enable processor interrupts (CLI). 


E .6 Firmware Handling of Interrupts 


When the user’s interrupt handler is called, it can identify the keyboard as 
the interrupt source by reading location $04FA. This is a copy of the ACIA 
status register at the time of the interrupt. If the interrupt was due to 
something on the ACIA for port 2, bit 7 is set. If the interrupt was caused by 
a keystroke, bit 6 is set and bit 5 is unchanged. 

After servicing this interrupt, the interrupt handler should clear the 
interrupt by setting $04FA to $00. 


E.6.3 Using External Interrupts Through Firmware 

Pin 9 of the external disk drive connector (EXTINT) can be used to generate 
interrupts through the ACIA for port 1. It can be used as a source of 
interrupts (on a high-to-low transition) if enabled as follows: 

1. Disable processor interrupts (SEI). 

2 . Set location $05F9 to $C0. This tells the firmware to identify an external 
interrupt, and to call the user’s interrupt handler. 

3. Turn on the ACIA for port 1 by setting the low nibble of $C09A to the 
value $0F. For example: 

lda $ c 09 A Read port 1 ACIA command register 

ora *$0F Set low nibble to $0F 

sta $C09A Set port 1 ACIA command register 

4 . Enable processor interrupts (CLI). 

When the user’s interrupt handler is called, it can identify this interrupt by 
reading location $04F9. This is a copy of the ACIA status register at the time 
of the interrupt. If the interrupt was due to something on the ACIA for 
port 1, bit 7 is set. If the interrupt was caused by the external interrupt line, 
bit 6 is clear and bit 5 is unchanged. 

After servicing this interrupt, the interrupt handler should clear the 
interrupt by setting $04F9 to $00. 


E.6.4 Firmware for Serial Interrupts 

The Apple lie hardware is able to generate interrupts both when the ACIA 
receives data and when it is ready to send data. The built-in interrupt 
handler responds to incoming data only. The firmware is able to buffer up to 
128 incoming bytes of serial data from either serial port. After the buffer is 
full, data are ignored. Only one port can be buffered at a time. The following 
sections assume that the serial port to be buffered is already initialized, as 
explained in Chapter 8. 
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Using Serial Buffering Transparently 

Serial buffering is automatically turned on when the serial firmware is 
placed in terminal mode. Otherwise you must turn it on yourself, as follows: 

1 . Disable processor interrupts (SEI). 

2 . Set location $04FF to $C1 to buffer port 1, or to $C2 to buffer port 2. 

3 . Set locations $057F and $067F to $00. These are pointers to the next 
byte in the buffer to be used and the next character to be read from the 
buffer, respectively. 

4 . Turn on the ACIA for the port by setting the low nibble of $C09A for 
port 1 or $C0AA for port 2 to $0D. For example: 

lda $ct)9A Read port 1 ACIA command register 
and $F 0 Clear low nibble 
□ra #$ 0 D Set low nibble to $0D 
sta $C09A Set port 1 ACIA command register 

The 0 in bit 1 of the command register enables receiver interrupts; thus 
an interrupt is generated when a byte of data is received. 

5 . Enable processor interrupts (CLI). 

When serial port buffering is thus enabled, normal reads from the serial port 
firmware fetch data from the buffer rather than directly from the ACIA. 


Using Serial Interrupts Through Firmware 

It is also possible to use the firmware to call the user interrupt handler 
whenever a byte of data is read by the ACIA. In this mode buffering is not 
performed by the firmware. 

1. Disable processor interrupts (SEI). 

2 . Set location $04FF to a value other than $C1 or $C2. 

3 . Turn on the ACIA for the port by setting the low nibble of $C09A for 
port 1 or $C0AA for port 2 to $0D. For example: 

lda $C09A Read port 1 ACIA command register 
and $F 0 Clear low nibble 
ora #$ 0 D Set low nibble to $0D 
sta $C09A Set port 1 ACIA command register 

The 0 in bit 1 of the command register enables receiver interrupts; thus 
an interrupt is generated when a byte of data is received. 

4 . Enable processor interrupts (CLI). 


E.6 Firmware Handling of Interrupts 
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When a serial port is thus enabled, the user’s interrupt handler is called 
each time the port receives a byte of data. The status byte saved by the 
firmware ($04F9 for port 1; $04FA for port 2) has the high bit set if the 
interrupt occurred on that port. Bit 3 is set if the interrupt was due to a 
received byte of data. 

The interrupt handler should clear the interrupt by clearing bits 7 and 3 of 
that port’s status byte ($04F9 for port 1; $04FA for port 2). 

Transmitting Serial Data 

The serial firmware does not implement buffering for serial output. Instead 
it waits for two conditions to be true before transmitting a character: 

□ The ACIA’s transmit register must be ready to accept a character. This is 
true if bit 4 of the ACIA’s status register is 1. 

□ The device must signal that it is ready to accept data. This is true if bit 5 
of the ACIA’s status register is 0. Bit 5 is 0 if pin 5 of the port’s connector 
is also 0. 

When the serial firmware is active, a change of state on pin 5 of that port 
generates an interrupt. That interrupt is absorbed, but the data remain in 
bit 5 of the status register. Interrupts from the ACIA’s transmit register are 
normally disabled. 

A Loophole in the Firmware 

So that programs can make use of interrupts on the ACIAs without affecting 
mouse interrupt handling, there is a tiny loophole purposely left in the 
built-in interrupt handler. If transmit interrupts are enabled on the ACIA— 
that is, if bits 3, 2, and 0 of the ACIA’s command register have the values 0, 

1, and 1, respectively— then control is passed to the user’s interrupt handler 
if the interrupt is not intended for the mouse (movement, button, or VBL). 

This means that you can write more sophisticated serial interrupt handling 
routines than the limited firmware space could provide (such as printer 
spooling). The firmware will still set memory to its standard state, handle 
mouse interrupts, and restore memory after your routine is finished. 

When you receive the interrupt, neither ACIA’s status register has been 
read. You are fully responsible for checking for interrupts on both ACIAs, 
determining which of the four interrupt sources on each ACIA caused the 
interrupt, and how to handle them. Refer to the 6551 specification for more 
details. The built-in firmware itself is an excellent example of how 
interrupts on the ACIA can be handled. 
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E.7 Bypassing the Interrupt Firmware 


The following sections give further details on using interrupts on the 
Apple lie computer without using the built-in interrupt handler. 

A method of handling mouse interrupts directly is described in Chapter 9. 


E.7.1 Using Mouse Interrupts Without the Firmware 

To use mouse interrupts without the firmware, as mentioned above, you 
must set your own interrupt vectors. If the $D000-$FFFF ROM is ever 
switched in, the built-in interrupt handler will absorb the mouse interrupts. 

Tables E-l and E-2 show how to activate and read mouse interrupts without 
using the firmware. Remember to disable interrupts (SEI) before enabling 
mouse interrupts, then turn them on when done (CLI). 


Table E-L Activating Mouse Interrupts 


To Activate 
Interrupts On 

Mouse X 
(rising edge) 

Mouse X 
(falling edge) 

Mouse Y 
(rising edge) 

Mouse Y 
(falling edge) 

VBL 


Enable IOU 
Access 

STA $C079 
STA $C079 
STA $C079 
STA $C079 
STA $C079 


Select 

Source 

STAIC05C 
STA $C05D 
STA $C05E 
STA $C05F 


Enable 

Source 

STA SC059 
STAIC059 
STA $C059 
STA SC059 
STA $C05B 


Disable 
IOU Access 

STAIC078 
STA $C078 
STA $C078 
STA $C078 
STA $C078 


E.7 Bypassing the Interrupt Firmware 
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TableE '-2. Reading Mouse Interrupts 


To Read 
Interrupts From 

Read Direction 
(A.S.A.P.) 

Determine Handle 

Source It 

Return 

Mouse X 

LDA $C066 

LDA $C015 
(bit 7=1 if true) 

RTI 

Mouse Y 

LDAIC067 

LDA $C017 
(bit 7=1 if true) 

RTI 

VBL 


LDA $C019 
(bit 7=1 if true) 

RTI 


The mouse direction data read from $C066 and $C067 are guaranteed valid 

for at least 40 microseconds, and average duration is at least 

200 microseconds, so you should read the direction as soon as possible. 


E.7.2 Using ACIA Interrupts Without the Firmware 

To use ACIA interrupts without the firmware, you must set your own 
interrupt vectors. If the $D000-$FFFF ROM is ever switched in, the built-in 
interrupt handler will handle the interrupt as determined by certain mode 
bytes (Section E.6.1). 

When writing your serial interrupt handler, refer to Figures 11-31 
through 11-33 and to the Synertek 6551 ACIA specification. As shown in 
Chapter 11, the ACIAs have the following connections: 

Port 1 : DSR line connected to the EXTINT line on the 

external disk port. 

DCD line connected to pin 5 of port 1 connector. 

Port 2: DSR line goes high when a key is pressed. 

DCD line connected to pin 5 of port 2 connector. 

The ACIA registers have the following addresses: 


Port 1: 


Port 2: 


Data register = 

$C098 

Data register = 

$C0A8 

Status register = 

$C099 

Status register = 

$C0A9 

Command register = 

$C09A 

Command register = 

$C0AA 

Control register = 

$C09B 

Control register = 

$C0AB 


334 


Appendix E: Interrupts 


Appendix F 


Apple II Series Differences 
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This appendix compares the Apple lie to the Apple He, Apple II Plus, and 
Apple II. It does not contain an exhaustive list of differences, but it does 
mention those differences most likely to affect the accuracy of programs, 
displays, and instructions created for end users of two or more Apple II 
series models. 


F.1 Overview 


The differences between the Apple II series computers can be expressed as 
a series of equations: this computer equals that one plus or minus certain 
features. 


Note: The following equations compare each model of Apple II series 
with its predecessor in terms of functional equivalence, not literal 
equality. For example, 

Apple II Plus = Apple II — Integer BASIC firmware 

does not mean that Integer BASIC firmware can be removed from the 
Apple II— just that the one machine functions as if it were the other 


without such firmware. 

Apple II Plus = II + 

+ 

+ 


Apple He = II Plus + 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 


Autostart ROM 
Applesoft firmware 
48K RAM standard 

old Monitor ROM 
Integer BASIC firmware 

Apple Language Card (with 16K of 
RAM) 

80-column (enhanced) video 
firmware 

built-in diagnostics 

full ASCII keyboard 

internal power light 

FCC approval 

improved back panel 

9-pin back panel game connector 

auxiliary slot (with possibility of 

80-column text card and extra 64K 

RAM) 
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+ 

+ 

Apple lie = He + 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 

+ 


+ 

+ 


slotO 

interrupt support in firmware 
(enhanced He) 

Mini-Assembler in firmware 
(enhanced He) 

extended 80-column text card 

80/40 switch 

keyboard switch 

disk-use light 

disk controller port 

disk drive 

mouse port 

serial printer port 

serial communication port 

built-in port firmware 

video expansion connector 

removable cover 

slots 1 to 7 

auxiliary slot 

internal power light 

cassette I/O connectors 

internal game I/O connector (hence 

no game output) 

auxiliary video pin 

Monitor cassette support 

Mini- Assembler in firmware (lie with 
UniDisk 3.5 support) 

Protocol Converter in firmware (lie 
with UniDisk 3.5 support) 


F.1.1 Type of Processor 

The processor in the Apple II and II Plus is the 6502. The original Apple He 
uses a 6502A. The Apple lie and enhanced Apple He both use the 65C02: 
this is a redesigned CMOS CPU that has 27 new instructions, new 
addressing modes, and for some instructions a differing execution scheme 
and machine cycle counts (see Appendix A). 


F.l Overview 
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Programs written for the Apple lie will run on the earlier machines only if 
they do not contain instructions unique to the 65C02, or depend on shared 
instructions whose cycle times differ. Programs should also use only 
published entry points in the Monitor firmware to allow maximum 
compatibility between different Apple II series computers. 


F.1.2 Machine Identification 


Identification of Apple II series computers is as shown in Table F-l. 


TableF-L Apple II Series Identification Bytes 


Machine 

$FBB3 

SFB1E 

$FBC0 

$FBBF 

Apple II 

$38 




Apple II Plus 

SEA 

SAD 



Apple He 

$06 


SEA 


Apple He (enhanced) 

$06 


$E0 


Apple lie 

$06 


$00 

$FF 

Apple lie (UniDisk 3.5 support) 
Apple III in Apple II 

$06 


$00 

$00 

emulation mode 

SEA 

< 

OO 

-e/9- 




Any future Apple II series computer or ROM release will have different 
values in these locations. Machine identification routines are available from 
Apple Vendor Technical Support. 

The MachID byte for ProDOS ($BF98 on the global page) will have bit 3 set 
to 0 if the computer is an Apple II, II Plus, He, or III, and to 1 if the computer 
is not one of these machines. In an Apple lie, bits 7 and 6 are also set to 
binary 10. 

Bits 7 and 6 set to binary 10 indicate that a computer is Apple He and lie 
compatible, regardless of the value of bit 3. 


F.2 Memory Structure 


This section compares the memory organization of the Apple lie with that of 
the Apple II, II Plus, and He. These machines differ in RAM space, ROM 
space, slot or port address space, and hardware page use. 
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F.2.1 Amount and Address Ranges of RAM 


The Apple II could have as little as 4K of RAM at the time of purchase, and 
could be upgraded to as much as 48K of RAM, following a procedure 
described in the Apple II Reference Manual. 

The Apple II Plus has 48K of RAM ($0000 through $BFFF) as a standard 
feature. With the addition of an Apple Language Card, a 48K Apple II or 
II Plus could be expanded to have 64K of RAM. 

The Apple He has a full 64K of RAM. The top 12K addresses overlap with 
the ROM addresses $D000 through $FFFF. There is an additional 
bank-switched area of 4K from $D000 through $DFFF. This arrangement is 
equivalent to an Apple II Plus with an Apple Language Card installed. A 
program selects between the RAM and ROM address spaces and between 
the $Dxxx banks by changing soft switches located in memory. 

With an Extended 80-Column Text Card installed in its auxiliary slot, an 
Apple lie has an additional 64K of RAM available, although no more than 
half of the 128K of RAM space is available at any given time. Soft switches 
located in memory control these address space selections. 

The RAM in the Apple lie is equivalent to the RAM in an Apple lie with an 
Extended 80-Column Card. 


F.2.2 Amount and Address Ranges of ROM 

The Apple II has 8K of ROM ($E000 through $FFFF), and the Apple II Plus 
has 12K of ROM ($DOOO through $FFFF). Users can plug their own ROMs 
into the sockets provided. The on-board (as opposed to slot) ROM address 
range is from $D000 through $FFFF. 

The Apple He has 16K of ROM, of which it uses 15.75 K (addresses $C100 
through $FFFF; page SCO addresses are for I/O hardware). ROM addresses 
$C300 through $C3FF (normally assigned to the ROM in a card in slot 3) and 
$C800 through $CFFF contain 80-column video firmware; ROM addresses 
SC100 through $C2FF and $C400 through $C7FF (normally assigned to the 
ROM on cards in slots 1, 2, 4, 5, 6, and 7) contain built-in self-test routines. 

A soft switch in RAM controls whether the video firmware or slot 3 card 
ROM is active. Invoking the self-tests with fTH controTH reset I causes 
the self-test firmware to take over the slot ROM address spaces. 


F.2 Memory Structure 


The Apple lie ROM also uses the 15.75 K from $C100 through $FFFF, and its 
enhanced video firmware has the same entry point addresses as on the 
Apple lie. However, there are only rudimentary built-in self-tests, and these 
do not preempt any port firmware space. 


UniDisk 3.5 


The Apple lie with built-in UniDisk 3.5 support has twice the ROM (32K) 
of the original Apple lie. The extra ROM contains support for the Protocol 
Converter, a Mini-Assembler, STEP and TRACE functions in the Monitor 
firmware, expanded self-test routines, and improved interrupt support. 


In the Apple lie, addresses $C100 through $CFFF contain I/O and interrupt 
firmware, addresses $D000 through $F7FF contain the Applesoft BASIC 
interpreter, and addresses $F800 through $FFFF contain the Monitor. 


F.2.3 Peripheral-Card Memory Spaces 

Each Apple lie port has up to 16 peripheral-card I/O space locations in main 
memory on the hardware page (beginning at location $C0s0 + $80 for slot or 
port s), allocated in the standard Apple II series way (that is, beginning at 
location $C0s0 + $80 for each slot s). 

The peripheral-card ROM space (page $Cs for slot s in the Apple II, II Plus, 
and He) contains the starting and entry-point addresses for port s, but port 
routines are not limited to their allocated $Cs pages. 

The 2K-byte expansion ROM space from $C800 to $CFFF in the Apple lie is 
used by the enhanced video firmware and miscellaneous I/O and 
memory-transfer routines. 

The 128 bytes of peripheral-card RAM space (or scratch-pad RAM) 

(64 screen holes in main memory and their equivalent addresses in 
auxiliary memory) are reserved for use by the built-in firmware. It is 
extremely important for the correct operation of Apple lie firmware that 
these locations not be altered by software except for the specific purposes 
described in Chapters 7, 8, and 9, and in Appendix E. 


F.2.4 Hardware Addresses 


The hardware page (the addresses from $0000 through $C0FF) controls 
memory selection and input/output hardware characteristics. All input and 
output (except video output) takes place at one or more hardware page 
addresses. For the sake of simplicity, this section presents only a general 
comparison between the Apple lie on the one hand, and the Apple II, II Plus, 
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and He on the other, with respect to hardware page use. However, for many 
characteristics, the Apple He and lie work one way, while the Apple II and 
II Plus work another. 

$COOO-$COOF 

On all Apple II series computers, reading any one of these addresses reads 
the keyboard data and strobe. On the Apple He and lie, writing to each of 
these addresses turns memory and display switches on and off. Writing to 
addresses $0006, $0007, $C00A, and $C00B performs ROM selection on the 
Apple He. Writing to these four addresses is reserved on the Apple lie. 

For reading the keyboard, use $C000; reserve $C001 through $C00F. 

$CQ10-$C01F 

On all Apple II series computers, writing to any one of these addresses 
clears the keyboard strobe. On the Apple He and lie, reading each of these 
addresses checks the status of a memory or display switch, or the 
any-key-down flag. 

For clearing the keyboard strobe, use $0010; reserve $C011 through $C01F. 

Reading $0015 checks the SLOTCXROM switch on the Apple He, but it 
resets the X-movement interrupt (Xlnt) on the Apple lie. Similarly, reading 
$C017 checks the SLOTC3ROM switch on the Apple He, but it resets the 
Y-movement interrupt (YInt) on the Apple lie. 

Reading $0019 checks the current state of vertical blanking (VBL) on the 
Apple He, but it resets the latched vertical blanking interrupt (VBUnt) on 
the Apple lie. 

$C020-$C02F 

On the Apple II, II Plus, and lie, reading any address $C02x toggles the 
cassette output signal. On the original Apple lie, both reading from and 
writing to these locations are reserved. The Apple lie with 32K of ROM uses 
$0028 to switch in or out the extra 16K of ROM. 

$C030-$C03F 

On all Apple II series computers, reading an address of the form $C03x 
toggles the speaker. For full Apple II series compatibility, toggle the speaker 
" using $0030, and reserve $0031 through $C03F. 

On the Apple lie, writing to $0031 through $C03F is explicitly reserved. 
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$C040-$C04F 


On the Apple II, II Plus, and He, reading any address of the form $C04x 
triggers the utility strobe. The Apple lie has no utility strobe. 

On the Apple lie, addresses $0044 through $0047 are explicitly reserved, 
and reading or writing any address from $0048 through $C04F resets both 
the X and Y mouse interrupts (XInt and YInt). 

$C050-$C05F 

Addresses $0050 through $0057 work the same on the Apple lie as on the 
Apple He: they turn the TEXT, MIXED, Page2, and HiRes switches on and 
off. 

On the Apple He, addresses $0058 through $C05F turn the annunciator 
outputs on and off. On an Apple He with a revision B main logic board or 
later, an Apple Extended 80-Column Text Card, and a jumper installed on 
the card, reading locations $C05E and $C05F set and clear 
double-high-resolution display mode. 

On the Apple lie, if the IOUDis switch is on, both reading from and writing 
to addresses $C058 through $C05D are reserved, and addresses $C05E and 
$C05F set and clear the double-high-resolution display (as on the Apple He 
equipped as described in the preceding paragraph). If the IOUDis switch is 
off, then addresses $C058 through $C05F control various characteristics of 
mouse and vertical blanking interrupts (Table 9-2). 

$C060-$C06F 

On the Apple lie, writing to any address of the form $C06x is reserved, and 
reading addresses $C068 through $C06F is reserved. 

Reading addresses $C061 and $C062 is the same as on the Apple He (switch 
inputs and Apple keys). Reading addresses $C064 and $C065 is the same as 
on all other Apple II series computers (analog inputs 0 and 1). 

On the Apple lie, address $C063 bit 7 is 1 if the mouse switch is not pressed, 
and 0 if it is pressed, so that software looking for the shift-key mod (used on 
Apple II, II Plus, and He with some text cards) will find it and display 
lowercase correctly. If by chance the mouse button is pressed when the 
software checks location $C063, it will appear that the shift-key mod is not 
present. 

On the Apple lie, address $C060 is used for reading the state of the 
80/40 switch; on the Apple II, II Plus, and He, this address is for reading 
cassette input. 
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The Apple lie has two, rather than four, analog (paddle) inputs. Addresses 
$C066 and $C067 are used for reading the mouse X and Y direction bits. 

$C070-$C07F 

On the Apple II, II Plus, and He, reading from or writing to any address of 
the form $C07x triggers the (analog input) paddle timers. 

On the Apple lie, only address $0070 is to be used for that one function. 
Addresses $0071 through $C07D are explicitly reserved. The results of 
reading from or writing to addresses $C07E and $C07F are described in 
Table 5-8. 

$C080-$C08F 

On the Apple He and lie, accessing addresses in this range selects different 
combinations of bank-switched memory banks. However, addresses $0084 
through $0087 duplicate the functions of the four addresses preceding 
them, and addresses $0080 through $C08F do also. These eight addresses 
are explicitly reserved on the Apple lie. 

$C090-$C0FF 

On the Apple II, II Plus, and He, each group of 16 addresses of the form 
$0080 + $s0 is allocated to an interface card (if present) in slot s. 

On the Apple lie, addresses corresponding to slots 1, 2, 3, 4, and 6 are 
allocated to a serial interface card, communication interface card, 
80-column text card, mouse interface card, and disk controller card, 
respectively. All other addresses in this range are reserved. 


F.2.5 Monitors 

The older models of the Apple II and Apple II Plus included a different 
version of the System Monitor from the one built into more recent models 
(and the Apple lie and lie). The older version, called the Monitor ROM, had 
the same standard I/O subroutines as the newer Autostart ROM, but a few 
of their features were different; for example, there were no arrow keys for 
vertical cursor motion. 
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When you start the Apple lie with a DOS ox BASICS disk and it loads 
Integer BASIC into the bank-switched area in RAM, it loads the old Monitor 
along with it. When you type I nt from Applesoft to activate Integer BASIC, 
you also activate this copy of the old Monitor, which remains active until 
you either type fp to switch back to Applesoft, which uses the new Monitor 
in ROM, or activate the 80-column firmware. 


F.3 I/O in General 


Apple lie I/O is different from I/O on the Apple II, II Plus, and He in three 
important respects: the possibility of direct memory access (DMA) 
transfers, the presence or absence of slots, and the presence or absence of 
built-in interrupt handling. 


F.3.1 DMA Transfers 

The Apple II, II Plus, and He allow DMA transfers, because both the address 
and the data bus are available at the slots. No true DMA transfer is possible 
with the Apple lie because neither bus is available at any of the back panel 
connectors. 


F.3.2 Slots Versus Ports 

The Apple II and II Plus have eight identical slots; the Apple lie has seven 
identical slots plus a 60-pin auxiliary slot for video, add-on memory, and test 
cards. The Apple lie has no slots; instead, it has back panel connectors and 
built-in hardware and firmware that are functional equivalents of slots with 
cards in them. The back panel connectors are called ports on the Apple lie. 


F.3.3 Interrupts 

The Apple lie is the first computer in the Apple II series to have built-in 
interrupt-handling capabilities. The enhanced Apple He has very similar 
interrupt-handling capability included. 
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F.4 Keyboard 


Both keyboard layout and character sets vary in the Apple II series 
computers. The major keyboard difference in the Apple II series is that the 
Apple He and lie have full ASCII keyboards, while the Apple II and II Plus 
do not. 


F.4.1 Keys, Switches, and Lights 

The Apple II and II Plus have identical 52-key keyboards. The Apple He and 
Apple lie keyboards have the same 63-key full ASCII keyboard layout, with 
new and repositioned keys and characters as compared to the Apple II and 
II Plus. While the Apple II and II Plus have a I rept I key, the He and lie have 
an auto-repeat feature built into each character key. 

Some Apple II and Apple II Plus machines have a slide switch inside the 
case, under the keyboard edge of the cover, for selecting whether or not 
I reset l works without I control | . On the Apple He and Apple lie, there is 
no choice: | control H reset 1 works, and I reset I alone does not. 

The Apple lie and He have an [o] and a [¥] key; the Apple II and II Plus do 
not have these two keys. 

The captions on several keys— [escaped , I tab | , | control | , I shift | , 

I caps lock - ! , I delete I , | return | , and l reset | — can vary: on the Apple II 
and II Plus some are abbreviated or missing; on the Apple lie all keycaps are 
lowercase italic; on international models, some captions are replaced by 
symbols (Appendix G). 

The Apple lie has two switches that the other models do not have. One 
switch is for changing between 40-column and 80-column display; the other 
is for selecting keyboard layout (Sholes versus Dvorak on USA models) or 
both keyboard layout and character set (on international models). 

The position of the power-on light differs on the Apple II and II Plus, 

Apple He, and Apple lie. The Apple lie has a disk-use light as well. 


F.4.2 Character Sets 


The Apple II and II Plus keyboard character sets are the same. They are 
described in th q Apple II Reference Manual. 


F.4 Keyboard 


345 


The Apple He and Apple lie keyboard character sets are the same: full 
ASCII. The standard (Sholes) layout and key assignments are described in 
the Apple lie Technical Reference Manual. The Dvorak layout and key 
assignments are described in Chapter 4 and Appendix G of this manual. 

To change between the two available keyboard layouts requires 
modification to the main logic board on the Apple He, but only toggling of 
the keyboard switch on the Apple lie. 

Apple Computer, Inc. manufactures fully localized models (with regard to 
power supply and character sets) of both the Apple lie and the Apple lie. 
However, there are minor variations in keyboard layout, even among early 
and late production models of the same machine. For further details, refer 
to Appendix G of this manual. 


F.5 Speaker 


The Apple lie has two speaker features that the three previous models do 
not have. They are a two-channel, but monaural, audio output jack for 
headphones— which disconnects the internal speaker when something is 
plugged into it— and a volume control. 


F.6 Video Display 


This section discusses the general differences between Apple lie video 
display capabilities and those of the other computers in the series. Note, 
however, that as new ROMs become available for the Apple He, many 
differences between these two machines will vanish. 


F.6.1 Character Sets 


The Apple II and II Plus display only uppercase characters, but they display 
them in three ways: normal, inverse, and flashing. The Apple lie and He can 
display uppercase characters in all three ways, and they can display 
lowercase characters in the normal way. This combination is called the 
primary character set. 
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The Apple lie and He have another character set, called the alternate 
character set, that displays a full set of normal and inverse uppercase and 
lowercase characters, but can’t display flashing characters. The primary 
and alternate character sets are described in Chapter 5. You can switch 
character sets at any time by means of the AltChar soft switch, also 
described in Chapter 5. 

Flashing display must not be used with the enhanced video firmware 
active. Use it in 40-column mode with the enhanced video firmware turned 
off; otherwise, strange displays may result, such as MouseText characters 
appearing in place of uppercase letters. 

To be sure of compatibility with some software, you have to switch the 
Apple lie keyboard to uppercase by pressing | caps lock! . 


F.6.2 MouseText 

MouseText characters (Chapter 5) are available on every Apple lie, and on 
the enhanced Apple He. 


F.6.3 Vertical Blanking 

A signal called vertical blanking indicates when a display device should 
stop projecting dots until the display mechanism returns from the bottom of 
the screen to the top to make another pass. During this interval, a program 
can make changes to display memory pages, and thus provide a smooth, 
flicker-free transition to a new display. 

On the Apple He, vertical blanking (VBL) is a signal whose level must be 
polled. (VBL is not available to software on the Apple II or II Plus.) On the 
Apple lie, vertical blanking is an interrupt (VBlInt) that occurs on the 
trailing edge of the active-low VBL signal. Programs intended to run on all 
Apple II series computers must take this difference into account. 


F.6.4 Display Modes 

All models have 40-column text mode, low-resolution graphics mode, 
high-resolution graphics mode, and mixed graphics and text modes. The 
Apple He (revision B motherboard) with an Apple Extended 80-Column 
Text Card, and the Apple lie have double-high-resolution graphics mode 
also. 
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F.7 Disk I/O 


The Apple II, II Plus, and lie can support up to six disk drives (although four 
is the recommended maximum) attached in controller cards plugged into 
slots 6, 5, and 4. The Apple lie supports up to two disk drives: its built-in 
drive (treated as slot 6, drive 1), and one external disk drive (treated as 
slot 6, drive 2; also treated as slot 7, drive 1 under ProDOS) for 
external-drive startup purposes. 


UniDisk 3.5 


The Apple lie with UniDisk 3.5 support does not use slot 7, drive 1 for 
external drives. They are handled through the Protocol Converter 
described in Chapter 6. The firmware for slot 7 ($C7xx) is needed for 
other parts of the firmware. 


F.8 Serial I/O 


The Apple lie serial ports (ports 1 and 2) are similar to Super Serial Cards 
installed in slots 1 and 2 of an Apple He. The serial port commands are a 
slightly modified subset of Super Serial Card commands. This subset 
includes all the commands supported by the earlier Apple Serial Interface 
Card and Communication Card. 


F.8.1 Serial Ports Versus Serial Cards 

There are several important differences between Apple lie serial ports and 
other Apple II series computers with serial cards installed in them. 

Apple lie serial ports have no switches. Instead, initial values are moved 
from firmware locations into auxiliary memory when the power is turned 
on. Changes made to these values in auxiliary memory remain in effect 
until the power is turned off. Pressing fcTH controTH reset | does not 
change them. 

When the port itself is turned on (with an IN or PR command), the initial 
values in auxiliary memory are placed in the main memory screen holes 
assigned to the port. These characteristics can be changed by the port 
commands. The changed characteristics remain in effect until the port is 
turned off and then on again (with PR and IN commands). 
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The command syntax for the Apple lie ports also differs from the syntax for 
serial cards. A separate command character, CONTROL-A or CONTROL-I, 
must precede each individual port command, whereas several commands to 
a serial card can be strung together between the command character and a 
carriage return character. 


The letters used for some of the commands have been changed from those 
used with the Super Serial Card (such as S instead of B for sending a 
BREAK signal). Each serial port command letter is unique, to simplify 
command interpretation. 

Changing the command character from CONTROL-A to CONTROL-I, or vice 
versa, makes the Super Serial Card change from communication mode to 
printer mode and back; this is not the case with Apple lie serial ports. With 
the Apple lie, use the System Utilities disk to change modes. 

Super Serial Card commands support some functions that Apple lie serial 
port commands don’t support: translating incoming characters, such as 
changing lowercase to uppercase (for the benefit of the Apple II or II Plus); 
delaying after sending carriage return, line feed, or form feed, and so on. 


UniDisk 3.5 


Several new serial port commands are available on the Apple lie with 
UniDisk 3.5 support. These commands have been added to make it easier 
to write programs for the lie that are also compatible with the Super 
Serial Card. See Chapters 7 and 8 for these new commands. 


Following a CONTROL-I nnnN command, the Apple lie automatically 
generates a carriage return after nnnN characters; with the Super Serial 
Card, you need to turn this on with CONTROL-I C. 


F.8.2 Serial I/O Buffers 


The communication port firmware uses auxiliary memory page $08 as an 
input and output buffer. By doing so, the firmware can keep up with higher 
baud rates. It can also hide data from the Monitor, Applesoft, and other 
system software. 

Programs written for the Apple He or lie can, of course, store information in 
auxiliary memory page $08. However, such information is destroyed when 
the communication port is activated. 
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F.9 Mouse and Hand Controllers 


The DB-9 back panel connector on the Apple lie is used for both the mouse 
and hand controllers. On the Apple He, the DB-9 connector supports hand 
controllers only; the mouse must use the connector on the interface card. 


F.9.1 Mouse Input 

The Apple lie provides built-in firmware support for a mouse connected to 
the DB-9 mouse and hand controller connector. Apple lie mouse support 
includes mouse movement and button interrupts (and vertical blanking 
interrupts for synchronization with the display); Apple He mouse support 
relies on polling VBL instead of vertical blanking interrupts. 

As a result of how interrupts are handled on the two machines, the mouse 
firmware routine calls function somewhat differently for the Apple lie and 
Apple lie. However, using the calls in the manner described in Chapter 9 
insures mouse support compatibility between the two machines. 

The ratio of mouse movement to cursor movement is different on the 
Apple lie from on the Apple He. 


F.9.2 Hand Controller Input and Output 

The Apple II, II Plus, and lie have a 16-pin game I/O connector inside the 
case that supports three switch inputs, four analog (paddle) inputs, and four 
annunciator outputs. The Apple He and Apple lie have a DB-9 back panel 
connector that supports the three switch inputs and two paddle inputs (plus 
two more on the internal GAME I/O connector of the Apple II, II Plus, 
and He). 

The Apple lie does not support the four annunciator outputs. 

The characteristic response curve for hand controllers differs for the 
Apple lie from that of the Apple II, II Plus, and He. Compare Figure F-l with 
Figure 11-42. This was done so the hardware would support identifiable 
mouse and hand controller signals using the same circuits. 

The paddle timing circuit on the Apple II Plus is slightly different from the 
one on the Apple lie and lie. On the Apple He and lie the 100-ohm fixed 
resistor is between the NE556 discharge lead and the capacitor; the variable 
resistor in the paddle is connected directly to the capacitor. On the 
Apple II Plus, the capacitor is connected directly to the discharge lead, and 
the fixed resistor is in series with the paddle resistor. 
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Input Current 
(mA) 


Undefined 


1 



Input Voltage 
(volts) 


F.10 Cassette I/O 


The Apple II, II Plus, and He all have cassette input and output jacks, 
memory locations, and Monitor support. The Apple lie does not. 


UniDisk 3.5 


If you plan to run a program on your lie that handles cassette I/O, make 
sure that it does not access $0028. The Apple lie with UniDisk 3.5 
support uses address $0028 to toggle between its two 16K banks of 
memory. 


F.11 Hardware 


Besides the different microprocessors used in various models in the Apple II 
series (Section F.1.1), there are important differences in power 
specifications and custom chips. 
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F.11.1 Power 


The power supplies for the Apple II, II Plus, and He are essentially the same. 
The floor transformer and voltage converter for the Apple lie have smaller 
capacity for current and heat dissipation. Therefore, it is important to 
observe the load limits specified in each of the reference manuals. 


F.11.2 Custom Chips 

The Apple He custom chips (memory management unit and input/output 
unit) replaced dozens of Apple II Plus chips, and added the functionality of 
dozens more. The Apple lie has custom MMU and IOU chips, too, but they 
represent different bonding options, and so their pin assignments are not 
compatible. 

In addition, the Apple lie has a custom general logic unit (GLU), timing 
generator (TMG), and disk controller unit (also known as an Integrated Woz 
Machine, or IWM). The Apple lie has two hybrid units (AUD and VID) for 
audio and video amplification. 
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This appendix repeats some of the keyboard information given in Chapter 4 
for the two USA keyboard layouts, for easy comparison with the other 
layouts available. Following these is a composite table of the ASCII codes 
and the characters associated with them on all the models discussed. 


G.1 Keyboard Layouts and Codes 


Each of the following subsections has a keyboard illustration and a table of 
the codes that result from the possible keystrokes. Note, however, that 
Table G-l is the basic table of keystrokes and their codes. For simplicity, 
subsequent tables (up to Table G-7) list only the keystrokes and codes that 
differ from those in Table G-l. 

For example, pressing the [a] key produces a (hexadecimal 61); pressing 
I shift U TI produces uppercase A (hexadecimal 41); pressing 
I control H~a~| or | control H shift HT] produces SON (the ASCII Start Of 
Header control character, hexadecimal 01). You can tell that this key has 
the same effect on all keyboards, from the fact that nothing appears in 
Tables G-2 through G-7 for that key. 

A quick way to find out which characters in the ASCII set change on 
international keyboards is to check Table G-8. In fact, only a few of them 
change. The pairing of characters on keys varies more. 

Note: On all but the French and Italian keyboards, | caps lock) affects 
only keys that can produce both lowercase letters (with or without an 
accent) and their uppercase equivalents. With these keys, | caps lock! 
down is equivalent to holding down | shift |, resulting in uppercase 
instead of lowercase. If a key produces only a lowercase version of an 
accented letter, then | caps lock! does not affect it. 

On the French and Italian keyboards, | caps lock) shifts all the keys. 
Furthermore, on the French keyboard, when | caps lock~| is down, the 
I shift | key undoes the shifting. 

The shapes and arrangement of keys in Figures G-l and G-2 follow the 
ANSI (American National Standards Institute) standard, which is used 
mainly in North and South America. The shapes and arrangement of keys 
in Figure G-3 follow the ISO (International Standards Organization) 
standard used in Europe and elsewhere. 
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The only differences between the ANSI and ISO versions of the USA 
keyboard are 

□ the shapes of three keys: the left | shift | key, I caps lock! and 
I return | 

D the resulting repositioning of two keys (Q] and Q) in Figures G-l 
and 0-3 

□ for some countries, the arrow symbols on | tab |, I caps lock! I return |, 
and the two | shift | keys (as shown in Figure G-3). 


G.1.1 USA Standard (Sholes) Keyboard 

Figure G-l shows the standard (Sholes) keyboard as it is laid out for USA 
models of the Apple lie with the keyboard switch up. Table G-l lists the 
ASCII codes resulting from all simple and combination keystrokes on this 
keyboard. 


Figure G-L USA Standard or Sholes Keyboard (Keyboard Switch Up) 


/reset / jj 80/40 jjk 


keyboard 
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Table G-l. Keys and ASCII Codes 

Note : Codes are in hexadecimal here; refer to Table G-8for decimal equivalents. 


Key 

Key Alone 

+ CONTROL 

+ SHIFT 

+ Both 


Code 

Char 

Code 

Char 

Code 

Char 

Code 

Char 

| DELETE | 

7F 

DEL 

7F 

DEL 

7F 

DEL 

7F 

DEL 

Q 

08 

BS 

08 

BS 

08 

BS 

08 

BS 

1 TAB | 

09 

HT 

09 

HT 

09 

HT 

09 

HT 

m 

0A 

LF 

0A 

LF 

0A 

LF 

0A 

LF 

ra 

OB 

VT 

0B 

VT 

0B 

VT 

0B 

VT 

| RETURN | 

0D 

CR 

0D 

CR 

0D 

CR 

0D 

CR 

Q 

15 

NAK 

15 

NAK 

15 

NAK 

15 

NAK 

1 ESC | 

IB 

ESC 

IB 

ESC 

IB 

ESC 

IB 

ESC 

| SPACE | 

20 

SP 

20 

SP 

20 

SP 

20 

SP 

> « 

27 

1 

27 

i 

22 

i) 

22 

» 

,< 

2C 

1 

2C 

J 

3C 

< 

3C 

< 

- — 

2D 

- 

IF 

US 

5F 



IF 

US 

. > 

2E 


2E 


3E 

> 

3E 

> 

/? 

2F 

/ 

2F 

/ 

3F 

? 

3F 

? 

0) 

30 

0 

30 

0 

29 

) 

29 

) 

1! 

31 

1 

31 

1 

21 

i 

21 

! 

2@ 

32 

2 

00 

NUL 

40 

@ 

00 

NUL 

3# 

33 

3 

33 

3 

23 

# 

23 

# 

4$ 

34 

4 

34 

4 

24 

$ 

24 

$ 

5% 

35 

5 

35 

5 

25 

% 

25 

% 

6 * 

36 

6 

IE 

RS 

5E 

- 

IE 

RS 

7 & 

37 

7 

37 

7 

26 

& 

26 

& 

8* 

38 

8 

38 

8 

2A 

* 

2A 

* 

9( 

39 

9 

39 

9 

28 

( 

28 

( 

) • 

3B 

1 

3B 

1 

3A 


3A 


= + 

3D 

= 

3D 

= 

2B 

+ 

2B 

+ 

[{ 

5B 

[ 

IB 

ESC 

7B 

{ 

IB 

ESC 

\l 

5C 

\ 

1C 

FS 

7C 

i 

1C 

FS 

]}. 

5D 

1 

ID 

GS 

7D 

} 

ID 

GS 


60 

v 

60 


7E 


7E 
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Table G-l— continued. Keys and ASCII Codes 

Note: Codes are in hexadecimal here; refer to Table G-8for decimal equivalents. 


Key 

Key Alone 

+ CONTROL 

+ SHIFT 

+ Both 


Code 

Char 

Code 

Char 

Code 

Char 

Code 

Char 

A 

61 

a 

01 

SOH 

41 

A 

01 

SOH 

B 

62 

b 

02 

STX 

42 

B 

02 

STX 

C 

63 

c 

03 

ETX 

43 

C 

03 

ETX 

D 

64 

d 

04 

EOT 

44 

D 

04 

EOT 

E 

65 

e 

05 

ENQ 

45 

E 

05 

ENQ 

F 

66 

f 

06 

ACK 

46 

F 

06 

ACK 

G 

67 

g 

07 

BEL 

47 

G 

07 

BEL 

H 

68 

h 

08 

BS 

48 

H 

08 

BS 

I 

69 

i 

09 

HT 

49 

1 

09 

HT 

J 

6A 

j 

0A 

LF 

4A 

J 

0A 

LF 

K 

6B 

k 

0B 

VT 

4B 

K 

0B 

VT 

L 

6C 

1 

OC 

FF 

4C 

L 

OC 

FF 

M 

6D 

m 

0D 

CR 

4D 

M 

0D 

CR 

N 

6E 

n 

0E 

SO 

4E 

N 

0E 

SO 

0 

6F 

0 

OF 

SI 

4F 

O 

OF 

SI 

P 

70 

P 

10 

DLE 

50 

P 

10 

DLE 

Q 

71 

q 

11 

DG1 

51 

Q 

11 

DC1 

R 

72 

r 

12 

DC2 

52 

R 

12 

DC2 

S 

73 

s 

13 

DC3 

53 

S 

13 

DC3 

T 

74 

t 

14 

DC4 

54 

T 

14 

DC4 

U 

75 

u 

15 

NAK 

55 

U 

15 

NAK 

V 

76 

V 

16 

SYN 

56 

V 

16 

SYN 

W 

77 

w 

17 

ETB 

57 

W 

17 

ETB 

X 

78 

X 

18 

CAN 

58 

X 

18 

CAN 

Y 

79 

y 

19 

EM 

59 

Y 

19 

EM 

Z 

7A 

z 

1A 

SUB 

5A 

Z 

1A 

SUB 
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G.1.2 USA Simplified (Dvorak) Keyboard 


Figure G-2 shows the Dvorak layout of the USA keyboard. Characters are 
paired up on keys in exactly the same way as on the USA standard 
keyboard; only individual key positions are changed. In fact, you can 
change the keycap arrangement to match Figure G-2, lock the keyboard 
switch in its down position, and have a working Dvorak keyboard. All 
keystrokes produce the same ASCII codes as those shown in Table G-l. 


Figure G-2. USA Simplified or Dvorak Keyboard (Keyboard Switch Down) 


/ 'eset / jj 80/40 IJkt 


keyboard 
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/ 


@ 

.? 

# 

3 

' $ 

4 

' % 

5 

/\ 

6 

4 

7 

* 

8 

' ( 

9 

' ) 

0 

' E 

[ 

1 } 

7 

delete 

tab 

// 

/ 

< 

> 

P 

Y 

F 

G 

C 

R 

L 

? 

i 

4- 


i 

\ 

control 

A 

0 

E 

U 

/ 

D 

H 

T 

N 

S 

— 

return 

i 

shift 


: 

Q 

J 

K 

X 

B 

M 

W 

V 

z 

shi 

ft 

caps 

lock 

r\j 

\ 


6 


* 


-> 

i 

t 
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G.1.3 ISO Layout of USA Keyboard 


Figure G-3 shows the layout of all ISO European keyboards (except the 
Italian keyboard) when the keyboard switch is up. All keystrokes produce 
the same ASCII codes as those shown in Table G-l. 


Figure G-3. ISO Version of USA Standard Keyboard (Keyboard Switch Up) 


/ 'eset / [] 80/40 jjsiss 


/■ /® 



/ 

@ 

# 

' $ 

' % 

s\ 
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* 
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+ 


esc 

/ 


3 

4 

5 

■6 

7 

8 

9 

0 



delete 


-H 


W 


{ 

[ 


J 
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// 

rj 
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A 

S 

D 

F 

G 
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J 
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L 

• 

/ 
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o 


O 
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G.1.4 English Keyboard 


With the keyboard switch up, the English model of the Apple lie keyboard 
layout is as shown in Figure G-3, and keystrokes produce the ASCII codes 
shown in Table G-l. 

With the keyboard switch down, the English model keyboard layout is as 
shown in Figure G-4. The change in ASCII code production (from that in 
Table G-l) is shown in Table G-2. 

The only changed character is the substitution of the British pound-sterling 
symbol (£) for the cross-hatch symbol (#) on the shifted 3-key. 


Figure g-4. English Keyboard (Keyboard Switch Down) 





Table G-2. English Keyboard Code Differences From Table G-l 

Note: Codes are in hexadecimal here ; re/er to Table G-8 for decimal equivalents. 


Key 

Key Alone 

+ CONTROL 

+ SHIFT 

+ Both 


Code Char 

Code 

Char 

Code Char 

Code Char 

3£ 

33 3 

33 

3 

23 £ 

23 # 
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G.1.5 French Keyboard 


With the keyboard switch up, the French model of the Apple lie keyboard 
layout is as shown in Figure G-3, and keystrokes produce the ASCII codes 
shown in Table 6-1. 

With the keyboard switch down, the French model keyboard layout is as 
shown in Figure G-5. The changes in ASCII code production (from that in 
Table 6-1) are shown in Table G-3. 

Note that on the French keyboard. I caps lock i shifts to the upper 
characters on all keys. With I caps lock | on, [ shift | “unshifts” to the lower 
character on any key pressed with it. 


Figure G-5. French Keyboard (Keyboard Switch Down) 
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Table G-3. French Keyboard Code Differences From Table G-l 

Note Codes are in hexadecimal, here ; refer_ to Table ff-ff for decimal equivalents. 


Key 

Key Alone 

+ CONTROL 

+ SHIFT 

+ Both 


Code 

Char 

Code 

Char 

Code 

Char 

Code 

Char 

&1 

26 

& 

26 

& 

31 

1 

31 

1 

e2 

7B 

e 

7B 

e 

32 

2 

32 

2 

”3 

22 

” 

22 


33 

3 

33 

3 

’4 

27 

> 

27 

’ 

34 

4 

34 

4 

(5 

28 

( 

28 

c 

35 

5 

35 

5 

§6 

5D 

§ 

ID 

GS 

36 

6 

ID 

GS 

e7 

7D 

e 

7D 

e 

37 

7 

37 

7 

!8 

21 

! 

21 

I 

38 

8 

38 

8 

C9 

5C 

q 

1C 

FS 

39 

9 

1C 

FS 

aO 

40 

a 

00 

NUL 

30 

0 

00 

NUL 

r 

29 

) 

IB 

ESC 

5B 

o 

IB 

ESC 


5E 


IE 

RS 

7E 

~ 

IE 

RS 

$* 

24 

$ 

24 

$ 

2A 

* 

2A 

* 

u% 

7C 

u 

7C 

it 

25 

% 

25 

% 

' & 

60 

- 

60 

' 

23 

£. 

23 

£ 

9 

J * 

2C 

j 

2C 

} 

3F 

? 

3F 

9 

) * 

3B 

> 

3B 

; 

2E 


2E 


7 

3A 


3A 


2F 

/ 

2F 

/ 


G.1.6 Canadian Keyboard 

With the keyboard switch up, the Canadian model of the Apple lie keyboard 
layout is as shown in Figure G-l, and keystrokes produce the ASCII codes 
shown in Table G-l. 

With the keyboard switch down, the Canadian model keyboard layout is as 
shown in Figure G-6. The changes in ASCII code production (from that in 
Table G-l) are shown in Table G-4. 
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Figure G-6. Canadian Keyboard (Keyboard Switch Down) 




Table G-4. Canadian Keyboard Code Differences From Table G-l 

Note: Codes are in hexadecimal here; refer to Table G-8 for decimal equivalents. 


Key 

Key Alone 

+ CONTROL 

+ SHIFT 

+ Both 


Code 

Char 

Code 

Char 

Code 

Char 

Code 

Char 

2° 

32 

2 

00 

NUL 

5B 

o 

00 

NUL 

CO 

33 

3 

33 

3 

23 

£ 

23 

S 

6§ 

36 

6 

RS 

IE 

5D 

£ 

RS 

IE 

ae 

40 

a 

7F 

DEL 

7D 

e 

7F 

DEL 

u * 

7C 

u 

7C 

u 

5E 

- 

5E 

» 

v ? 

60 


ESC 

IB 

3F 

? 

ID 

GS 

eg 

7B 

e 

1C 

FS 

5C 

g 

1C 

FS 

V 

7E 

n 

7E 

» 

2F 

/ 

2F 

/ 
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G.1.7 German Keyboard 


With the keyboard switch up, the German model of the Apple lie keyboard 
layout is as shown in Figure G-3, and keystrokes produce the ASCII codes 
shown in Table G-l. 

With the keyboard switch down, the German model keyboard layout is as 
shown in Figure G-7. The change in ASCII code production (from that in 
Table G-l) is shown in Table G-5. 


Figure g-7. German Keyboard (Keyboard Switch Down) 
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Table G-5. German Keyboard Code Differences From Table G-l 

Note: Codes are in hexadecimal here; refer to Table G-8 for decimal equivalents. 


Key 

Key Alone 

+ CONTROL 

+ SHIFT 

+ Both 


Code 

Char 

Code 

Char 

Code 

Char 

Code 

Char 

2” 

32 

2 

32 

2 

22 

» 

22 


3§ 

33 

3 

00 

NUL 

40 

§ 

00 

NUL 

6& 

36 

6 

36 

6 

26 

& 

26 

& 

7/ 

37 

7 

37 

7 

2F 

/ 

2F 

/ 

8( 

38 

8 

38 

8 

28 

( 

28 

( 

9) 

39 

9 

39 

9 

29 

) 

29 

) 

0 = 

30 

0 

30 

0 

3D 

= 

3D 

= 

£? 

7E 

8 

7E 

8 

3F 

? 

3F 

9 

0 

7D 

U 

ID 

GS 

5D 

u 

ID 

GS 

+ * 

2B 

+ 

2B 

+ 

2A 

* 

2A 

* 

0 

7C 

0 

1C 

FS 

5C 

0 

1C 

FS 

A 

7B 

A 

IB 

ESC 

5B 

A 

IB 

ESC 

# * 

23 

# 

IE 

RS 

5E 


IE 

RS 

< > 

3C 

< 

3C 

< 

3E 

> 

3E 

> 

> ) 

2C 

> 

2C 

1 

3B 

1 

3B 

1 


2E 


2E 


3A 


3A 
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G.1.8 Italian Keyboard 


With the keyboard switch down, the Italian model keyboard layout is as 
shown in Figure G-8. The change in ASCII code production (from that in 
Table G-l) is shown in Table G-6. 

With the keyboard switch up, the Italian model keyboard produces exactly 
the same ASCII codes for each key, but what is displayed differs for the ten 
characters indicated with the circled numbers 0, 2-5, and 7-11 in Table G-8. 


Figure (F8. Italian Keyboard (Keyboard Switch Down) 
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Table G-6. Italian Keyboard Code Differences From Table G-l 

Note: Codes are in hexadecimal here; refer to Table G-8for decimal equivalents. 


Key 

Key Alone 

+ CONTROL 

+ SHIFT 

+ Both 


Code 

Char 

Code 

Char 

Code 

Char 

Code 

Char 

& 1 

26 

& 

26 

& 

31 

1 

31 

1 

”2 

22 

M 

22 

» 

32 

2 

32 

2 

’3 

27 


27 

’ 

33 

3 

33 

3 

(4 

28 

( 

28 

( 

34 

4 

34 

4 

C5 

5C 

Q 

1C 

FS 

35 

5 

1C 

FS 

e 6 

7D 

e 

7D 

e 

36 

6 

36 

6 

)7 

29 

) 

29 

) 

37 

7 

37 

7 

OO 

08 

23 

& 

23 

£ 

38 

8 

38 

8 

a9 

7B 

a 

7B 

a 

39 

9 

39 

9 

eO 

5D 

e 

ID 

GS 

30 

0 

ID 

GS 

1 " 

7E 

l 

IE 

RS 

5E 

* 

IE 

RS 

$* 

24 

$ 

24 

$ 

2A 

* 

2A 

* 

u% 

60 

u 

60 

u 

25 

% 

25 

% 

§° 

40 

§ 

00 

NUL 

5B 

o 

IB 

ESC 

< > 

3C 

< 

3C 

< 

3E 

> 

3E 

> 

? 

) * 

2C 

> 

2C 

J 

3F 

? 

3F 

? 

J * 

3B 

5 

3B 

) 

2E 


2E 


7 

3A 


3A 


2F 

/ 

2F 

/ 

6 ! 

7C 

6 

7C 

0 

21 

J 

21 

j 
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G.1.9 Western Spanish Keyboard 


With the keyboard switch up, the Western (that is, American) Spanish 
model of the lie keyboard layout is as shown in Figure G-l, and keystrokes 
produce the ASCII codes shown in Table G-l. 

With the keyboard switch down, the Western Spanish model keyboard 
layout is as shown in Figure G-9. The change in ASCII code production 
(from that in Table G-l) is shown in Table G-7. 


Figure G-9. Western Spanish Keyboard (Keyboard Switch Down) 
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Table G-7. Western Spanish Keyboard Code Differences From Table G-l 
Note: Codes are in hexadecimal here; refer to Table G-8 for decimal equivalents. 


Key 

Key Alone 

+ CONTROL 

+ SHIFT 

+ Both 


Code 

Char 

Code 

Char 

Code 

Char 

Code 

Char 

li 

31 

1 

31 

1 

5B 

i 

5B 

i 

2i 

32 

2 

32 

2 

5D 


5D 

£ 

3£ 

33 

3 

33 

3 

23 

£ 

23 


6/ 

36 

6 

36 

6 

2F 

/ 

2F 

/ 

' O 

27 

' 

27 

' 

7B 

0 

7B 

0 


60 


00 

NUL 

5E 

- 

00 

NUL 

~ § 

7E 

- 

7F 

DEL 

40 

§ 

7F 

DEL 

N 

7C 

h 

1C 

FS 

5C 

N 

1C 

FS 

9 

J • 

2C 

) 

2C 

> 

3F 

9 

3F 

? 

. 1 

2E 


2E 


21 

! 

21 

1 

c" 

7D 

C 

ID 

GS 

22 

» 

ID 

GS 

< > 

3C 

< 

IE 

RS 

3E 

> 

IE 

RS 
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G.2 ASCII Character Sets 


Table G-8 lists the ASCII (American National Standard Code for Information 
Interchange) codes that the Apple lie uses, as well as the decimal and 
hexadecimal equivalents. Where there are differences between character 
sets, an asterisked number in the main table refers to a column in the 
following part of the table. 


Table G-8. ASCII Code Equivalents 


ASCII 

Dec Hex 

ASCII Dec 

Hex 

ASCII 

Dec 

Hex 

ASCII 

Dec 

Hex 

NUL 

00 

00 

SP 

32 

20 

2 * 

64 

40 

7* 

96 

60 

SOH 

01 

01 

! 

33 

21 

A 

65 

41 

a 

97 

61 

STX 

02 

02 

n 

34 

22 

B 

66 

42 

b 

98 

62 

ETX 

03 

03 

0 * 

35 

23 

C 

67 

43 

c 

99 

63 

EOT 

04 

04 

1 * 

36 

24 

D 

68 

44 

d 

100 

64 

ENQ 

05 

05 

% 

37 

25 

E 

69 

45 

e 

101 

65 

ACK 

06 

06 

& 

38 

26 

F 

70 

46 

f 

102 

66 

BEL 

07 

07 

> 

39 

27 

G 

71 

47 

g 

103 

67 

BS 

08 

08 

( 

40 

28 

H 

72 

48 

h 

104 

68 

HT 

09 

09 

) 

41 

29 

I 

73 

49 

i 

105 

69 

LF 

10 

0A 

* 

42 

2A 

J 

74 

4A 

j 

106 

6 A 

VT 

11 

0B 

+ 

43 

2B 

K 

75 

4B 

k 

107 

6 B 

FF 

12 

OC 

> 

44 

2C 

L 

76 

4C 

1 

108 

6 C 

CR 

13 

0D 


45 

2D 

M 

77 

4D 

m 

109 

6 D 

SO 

14 

0E 


46 

2E 

N 

78 

4E 

n 

110 

6 E 

SI 

15 

OF 

/ 

47 

2F 

O 

79 

4F 

0 

111 

6 F 

DLE 

16 

10 

0 

48 

30 

P 

80 

50 

P 

112 

70 

DC1 

17 

11 

1 

49 

31 

Q 

81 

51 

q 

113 

71 

DC2 

18 

12 

2 

50 

32 

R 

82 

52 

r 

114 

72 

DC3 

19 

13 

3 

51 

33 

S 

83 

53 

s 

115 

73 

DC4 

20 

14 

4 

52 

34 

T 

84 

54 

t 

116 

74 

NAK 

21 

15 

5 

53 

35 

U 

85 

55 

u 

117 

75 

SYN 

22 

16 

6 

54 

36 

V 

86 

56 

V 

118 

76 

ETB 

23 

17 

7 

55 

37 

W 

87 

57 

w 

119 

77 

CAN 

24 

18 

8 

56 

38 

X 

88 

58 

X 

120 

78 

EM 

25 

19 

9 

57 

39 

Y 

89 

59 

y 

121 

79 

SUB 

26 

1A 


58 

3A 

Z 

90 

5A 

z 

122 

7A 

ESC 

27 

IB 

J 

59 

3B 

3* 

91 

5B 

8 * 

123 

7B 

FS 

28 

1C 

< 

60 

3C 

4 * 

92 

5C 

9* 

124 

7C 

GS 

29 

ID 

= 

61 

3D 

5* 

93 

5D 

10 * 

125 

7D 

RS 

30 

IE 

> 

62 

3E 

6 * 

94 

5E 

11* 

126 

7E 

US 

31 

IF 

? 

63 

3F 

— 

95 

5F 

DEL 

127 

7F 
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Table G-8— continued. ASCII Code Equivalents 

Note: These characters correspond to those followed by an asterisk in the preceding 
part of the table. 


* 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

Hexadecimal 

23 

24 

40 

5B 

5C 

5D 

5E 

60 

7B 

7C 

7D 

7E 

English (USA) 

# 

$ 

@ 

[ 

\ 

] 

- 

- 

{ 

1 

} 


English (UK) 

£ 

$ 

@ 

[ 

\ 

1 

* 


{ 

1 

} 


German 

# 

$ 

§ 

A 

0 

U 

- 


a 

6 

ii 

£ 

French 

£ 

$ 

a 

o 

C 

§ 

- 

- 

e 

u 

e 


Italian 

£ 

$ 

§ 

o 

Q 

e 

- 

u 

a 

6 

e 

1 

Spanish 

£ 

$ 

§ 

i 

N 

i 

- 


o 

n 

G 



G.3 Certification 


In the countries where it is applicable, the following product safety 
certification supplements the USA FCC Class B notice printed on the inside 
front cover of this manual. The safety instructions apply to all countries. 


G.3.1 Product Safety 

This product is designed to meet the requirements of safety standard 
IEC 380, Safety of Electrically Energized Office Machines. 


G.3.2 Important Safety Instructions 

This equipment is intended to be electrically grounded. This product is 
equipped with a plug having a third (grounding) pin. This plug will fit only 
into a grounding-type alternating current outlet. This is a safety feature. 

If you are unable to insert the plug into the outlet, contact a licensed 
electrician to replace the outlet and, if necessary, install a grounding 
conductor. 

Do not defeat the purpose of the grounding-type plug. 
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G.4 Power Supply Specifications 


The basic specifications of the power supply furnished with the Apple lie 
for use in Europe and other countries having 50-Hz alternating current are 
shown in Table 6-8. 

Table G-8. 50-Hz Power Supply Specifications 


Line voltage: 

199 to 255 VAC, 50 Hz 

Maximum input 
power consumption: 

25 W 

Supply voltage: 

Supply current: 

+15 VDC (nominal) 

1.2 A (nominal) 


Appendix G: USA and International Models 


Appendix H 


Conversion Tables 
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This appendix briefly discusses bits and bytes and what they can represent, 
and peripheral identification numbers. It also contains conversion tables for 
hexadecimal to decimal and negative decimal, and a number of 8-bit codes. 

These tables are intended for convenient reference. This appendix is not 
intended as a tutorial for the materials discussed. The brief section 
introductions are for orientation only. 


H.1 Bits and Bytes 

This section discusses the relationships between bit values and their 

position within a byte. Here are some rules of thumb regarding the 65C02: 

□ A bit is a binary digit; it can be either a 0 or a 1. 

□ A bit can be used to represent any two-way choice. Some choices that a 
bit can represent in the Apple lie are listed in Table H-l. 

□ Bits can also be combined in groups of any size to represent numbers. 
Most of the commonly used sizes are multiples of four bits. 

□ Four bits comprise a nibble (sometimes spelled nybble ). 

□ One nibble can represent any of 16 values. Each of these values is 
assigned a number from 0 through 9 and (because our decimal system 
has only 10 of the 16 digits we need) A through F. 

n Eight bits (two nibbles) make a byte (Figure H-l). 

□ One byte can represent any of 16 x 16 or 256 values. The value can be 
specified by exactly two hexadecimal digits. 

□ Bits within a byte are numbered from bit 0 on the right to bit 7 on the left. 

□ The bit number is the same as the power of 2 that it represents, in a 
manner completely analogous to the digits in a decimal number. 

□ One memory position in the Apple lie contains one 8-bit byte of data. 

□ How byte values are interpreted depends on whether the byte is an 
instruction in a language, part or all of an address, an ASCII code, or 
some other form of data. Tables H-5 through H-8 list some of the ways 
bytes are commonly interpreted. 

□ Two bytes make a word. The 16 bits of a word can represent any one of 
256 x 256, or 65536, different values. 

□ The 65C02 uses a 16-bit word to represent memory locations. It can 
therefore distinguish among 65536 (64K) locations at any given time. 

□ A memory location is one byte of a 256-byte page. The low-order byte of 
an address specifies this byte. The high-order byte specifies the memory 
page the byte is on. 
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Table H-l. What a Bit Can Represent 


Context 

Representing 

0 = 

1 = 

Binary number 

Place value 

0 

1 x that power of 2 

Logic 

Condition 

False 

True 

Any switch 

Position 

Off 

On 

Any switch 

Position 

Clear* 

Set 

Serial transfer 

Beginning 

Start 

Carrier (no information yet) 

Serial transfer 

Data 

0 value 

1 value 

Serial transfer 

Parity 

SPACE 

MARK 

Serial transfer 

End 


Stop bit(s) 

Serial transfer 

Communication 

state 

BREAK 

Carrier 

P reg. bit N 

Neg. result? 

No 

Yes 

P reg. bit V 

Overflow? 

No 

Yes 

P reg. bit B 

BRK command? 

No 

Yes 

P reg. bit D 

Decimal mode? 

No 

Yes 

P reg. bit I 

IRQ interrupts 

Enabled 

Disabled (masked out) 

P reg. bit Z 

Zero result? 

No 

Yes 

P reg. bit C 

Carry required? 

No 

Yes 


* Sometimes ambiguously termed reset. 


Figure H-l. Bits, Nibbles, and Bytes 


High Nibble Low Nibble 


^ MSB 

7 

6 

5 

V 

4 3 

> 

2 

1 

LSB 

0 










Hexadecimal 

$80 

$40 

$20 

$10 

$08 

$04 

$02 

$01 

Decimal 

128 

64 

32 

16 

8 

4 

2 

1 


Binary 

Hex 

Dec 

Binary 

Hex 

Dec 

0000 

$0 

0 

1000 

$8 

8 

0001 

$1 

1 

1001 

$9 

9 

0010 

$2 2 

1010 

$A 

10 

0011 

$3 3 

1011 

$B 

11 

0100 

$4 

4 

1100 

$C 

12 

0101 

$5 

5 

1101 

$D 

13 

0110 

$6 

6 

1110 

$E 

14 

0111 

$7 7 

mi 

$F 

15 
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H.2 Hexadecimal and Decimal 


Use Table H-2 for conversion of hexadecimal and decimal numbers. 


TableH-2. Hexadecimal/Decimal Conversion 


Digit 

$x000 

$0x00 

$00x0 

$000x 

F 

61440 

3840 

240 

15 

E 

57344 

3584 

224 

14 

D 

53248 

3328 

208 

13 

C 

49152 

3072 

192 

12 

B 

45056 

2816 

176 

11 

A 

40960 

2560 

160 

10 

9 

36864 

2304 

144 

9 

8 

32768 

2048 

128 

8 

7 

28672 

1792 

112 

7 

6 

24576 

1536 

96 

6 

5 

20480 

1280 

80 

5 

4 

16384 

1024 

64 

4 

3 

12288 

768 

48 

3 

2 

8192 

512 

32 

2 

1 

4096 

256 

16 

1 


To convert a hexadecimal number to a decimal number, find the decimal 
numbers corresponding to the positions of each hexadecimal digit. Write 
them down and add them up. 

Examples: 


$3C 

$30 

$0C 


$3C 


= ? 

$ FD47 

= ? 

= 48 

$ F 0 0 0 

= 61440 

= 12 

$ D00 

= 3328 


$ 40 

= 64 


$ 7 

= 7 

= 60 




$FD47 = 64839 


To convert a decimal number to hexadecimal, subtract from the decimal 
number the largest decimal entry in the table that is less than it. Write 
down the hexadecimal digit (noting its place value) also. Now subtract the 
largest decimal number in the table that is less than the decimal remainder, 
and write down the next hexadecimal digit. Continue until you have 0 left. 
Add up the hexadecimal numbers. 
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Example: 


16215 = 

$ ? 


16215 - 

12288 = 3927 

12288 = $7000 

3927 - 

3840 = 87 

3840 = $ F00 

87 - 

80 -7 

80 = $ 50 


7 

7 = $ 7 


16215 = $ 7F57 


H.3 Hexadecimal and Negative Decimal 


If a number is larger than decimal 32767, Applesoft BASIC allows and 
Integer BASIC requires you to use the negative-decimal equivalent of the 
number. Table H-3 is set up to make it easy for you to convert a 
hexadecimal number directly to a negative-decimal number. 


Table H-3. Hexadecimal to Negative Decimal Conversion 


Digit 

$x000 

$$0x00 

$$00x0 

$$000x 

F 

0 

0 

0 

-1 

E 

-4096 

-256 

-16 

-2 

D 

-8192 

-512 

-32 

-3 

C 

-12288 

- 768 

-48 

-4 

B 

-16384 

-1024 

-64 

-5 

A 

-20480 

-1280 

-80 

-6 

9 

-24576 

-1536 

-96 

-7 

8 

-28672 

-1792 

-112 

-8 

7 


-2048 

-128 

-9 

6 


-2304 

-144 

-10 

5 


-2560 

-160 

-11 

4 


-2816 

-176 

-12 

3 


-3072 

-192 

-13 

2 


-3328 

-208 

-14 

1 


-3584 

-224 

-15 

0 


-3840 

-240 

-16 
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To perform this conversion, write down the four decimal numbers 
corresponding to the four hexadecimal digits (Os included). Then add their 
values (ignoring their signs for a moment). The resulting number, with a 
minus sign in front of it, is the desired negative-decimal number. 

Example: 


$C010 

= - ? 

$C000 

-12288 

$ 000 

- 3840 

$ 10 

- 224 

$ 0 

16 

$C010 

-16368 


To convert a negative-decimal number directly to a positive-decimal 
number, add it to 65536. (This addition ends up looking like subtraction.) 

Example: 

-151 = ♦ ? 

65536 + C - 1 5 1 > = 65536 - 151 = 65385 

To convert a negative-decimal number to a hexadecimal number, first 
convert it to a positive-decimal number, then use Table H-2. 


H.4 Peripheral Identification Numbers 


Many Apple products now use peripheral identification numbers (called 
PIN numbers) as shorthand to designate serial device characteristics. The 
Apple II series Universal Utilities disk presents a menu from which to 
select the characteristics of, say, a printer or modem. From the selections 
made, it generates a PIN for the user. Other products have a ready-made 
PIN that the user can simply type in. 

Table H-4 is a definition of the PIN number digits. When communication 
mode is selected, the seventh digit is ignored. 

Example: 252/1111 means: 

Communication mode No parity 

8 data bits, 1 stop bit Do not echo output to display 

300 baud (bits per second) No line feed after carriage return 

Do not generate carriage returns 
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Table H-4. PIN Numbers 


1 = Printer mode 

2 = Communication mode* 

1 = 6 data bits, 1 stop bit 

2 = 6 data bits, 2 stop bits 

3 = 7 data bits, 1 stop bit 

4 = 7 data bits, 2 stop bits 

5 = 8 data bits, 1 stop bit 

6 = 8 data bits, 2 stop bits 

1 = 110 bits per second 

2 = 300 bits per second 

3 = 1200 bits per second 

4 = 2400 bits per second 

5 = 4800 bits per second 

6 = 9600 bits per second 

7 = 19200 bits per second 


xxx 



/ x x x 


x 


1 = No parity 

2 = Even parity (total on = even) 

3 = Odd parity (total on = odd) 

4 = MARK parity (parity bit = 1) 

5 = SPACE parity (parity bit = 0) 

1 = Do not echo output on screen 

2 = Echo output on screen 

1 = Do not generate LF after CR 

2 = Generate LF after CR 

1 = Do not generate CR* 

2 = Generate CR after 40 characters 

3 = Generate CR after 72 characters 

4 = Generate CR after 80 characters 

5 = Generate CR after 132 characters_ 

* If you select communication mode, then seventh digit must equal 1. This value is supplied automatically when you use the UUD. 
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H.5 Eight-Bit Code Conversions 


Tables H-5 through H-8 show the entire ASCII character set. Note that 
character values are shown with the high bit off. Unless otherwise noted, all 
ASCII character values above $7F (127 decimal) generate the same 
character as that value with the high bit off. Here is how to interpret these 
tables: 

□ The Binary column has the 8-bit code for each ASCII character. 

□ The first 128 ASCII entries represent 7-bit ASCII codes plus a high-order 
bit of 0 (SPACE parity or Pascal)— for example, 01001000 for the 
letter H. 

□ The last 128 ASCII entries (from 128 through 255) represent 7-bit ASCII 
codes plus a high-order bit of 1 (MARK parity or BASIC)— for example, 
11001000 for the letter H. 

□ A transmitted or received ASCII character will take whichever form (in 
the communication register) is appropriate if odd or even parity is 
selected— for example, 11001000 for an odd-parity 77, 01001000 for an 
even-parity H. 

□ The ASCII Char column gives the ASCII character name. 

□ The Interpretation column spells out the meaning of special symbols 
and abbreviations, where necessary. 

□ The What to Type column indicates what keystrokes generate the ASCII 
character (where it is not obvious). 

□ The columns marked Pri and Alt indicate what displayed character 
results from each code when using the primary or alternate display 
character set, respectively. Boldface is used for inverse characters; italic 
is used for flashing characters. 

Note that the values $40 through $5F (and $C0 through $DF) in the 
alternate character set are displayed as MouseText characters 
(Figure 5-1) if the firmware is set to do so (Section 5.2.2), or if the 
firmware is bypassed. 

Note: The primary and alternate displayed character sets in Tables H-5 
through H-8 are the result of firmware mapping. The character generator 
ROM actually contains only one character set. The firmware mapping 
procedure is described in Section 3.3.6. 
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Table H-5. Control Characters, High Bit Off 


Binary 

Dec 

Hex 

ASCII 

Char 

Interpretation 

What to Type 

Pri 

Alt 

0000000 

0 

$00 

NUL 

Blank (null) 

| CONTROL |-| @ | 

@ 

@ 

0000001 

1 

$01 

SOH 

Start of Header 

| CONTROL |-| A | 

A 

A 

0000010 

2 

$02 

STX 

Start of Text 

| CONTROL |-| B | 

B 

B 

0000011 

3 

$03 

ETX 

End of Text 

| CONTROL |-| C | 

C 

C 

0000100 

4 

$04 

EOT 

End of Transm. 

I CONTROL H D | 

D 

D 

0000101 

5 

$05 

ENQ 

Enquiry 

| CONTROL H E | 

E 

E 

0000110 

6 

$06 

ACK 

Acknowledge 

| CONTROL H F | 

F 

F 

0000111 

7 

$07 

BEL 

Bell 

| CONTROL 1-fGl 

G 

G 

0001000 

8 

$08 

BS 

Backspace 

| CONTROL 1-fHl Or P^l 

H 

H 

0001001 

9 

$09 

HT 

Horizontal Tab 

| CONTROL |-[ 1 | Or [ TAB | 

I 

I 

0001010 

10 

$0A 

LF 

Line Feed 

1 control |-| j 1 or (T] 

J 

J 

0001011 

11 

$0B 

VT 

Vertical Tab 

I control |Tk~| or |T| 

K 

K 

0001100 

12 

$0C 

FF 

Form Feed 

| CONTROL |-| L | 

L 

L 

0001101 

13 

$0D 

CR 

Carriage Return 

| CONTROL l-m Or | RETURN | 

M 

M 

0001110 

14 

$0E 

SO 

Shift Out 

| CONTROL |-| N | 

N 

N 

0001111 

15 

$0F 

SI 

Shift In 

| CONTROL |-| 0 | 

O 

O 

0010000 

16 

$10 

DLE 

Data Link Escape 

| CONTROL |-| P | 

P 

P 

0010001 

17 

$11 

DC1 

Device Control 1 

| CONTROL |-| Q | 

Q 

Q 

0010010 

18 

$12 

DC2 

Device Control 2 

| CONTROL H R | 

R 

R 

0010011 

19 

$13 

DC3 

Device Control 3 

| CONTROL H S | 

S 

S 

0010100 

20 

$14 

DC4 

Device Control 4 

| CONTROL |-| T | 

T 

T 

0010101 

21 

$15 

NAK 

Neg. Acknowledge 

i control i-rui or rn 

U 

U 

0010110 

22 

$16 

SYN 

Synchronization 

| CONTROL H V | 

V 

V 

0010111 

23 

$17 

ETB 

End of Text Blk. 

| CONTROL |-| W | 

W 

w 

0011000 

24 

$18 

CAN 

Cancel 

| CONTROL H X | 

X 

X 

0011001 

25 

$19 

EM 

End of Medium 

| CONTROL |-| Y | 

Y 

Y 

0011010 

26 

$1A 

SUB 

Substitute 

| CONTROL tfzl 

Z 

Z 

0011011 

27 

$1B 

ESC 

Escape 

| CONTROL |-| [ | Or | ESC | 

[ 

[ 

0011100 

28 

$1C 

FS 

File Separator 

| CONTROL |-| \ 1 

\ 

\ 

0011101 

29 

$1D 

GS 

Group Separator 

| CONTROL |-| ] | 

] 

] 

0011110 

30 

$1E 

RS 

Record Separator 

| CONTROL H A | 

- 


0011111 

31 

$1F 

US 

Unit Separator 

| CONTROL H 1 

— 

— 
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Table H-6. Special Characters, High Bit Off 





ASCII 





Binary 

Dec 

Hex 

Char 

Interpretation 

What to Type 

Pri 

Alt 

0100000 

32 

$20 

SP 

Space 

1 space | bar 



0100001 

33 

$21 

j 



| 

j 

0100010 

34 

$22 

” 



« 


0100011 

35 

$23 

# 



# 

# 

0100100 

36 

$24 

$ 



$ 

$ 

0100101 

37 

$25 

% 



% 

% 

0100110 

38 

$26 

& 



& 

& 

0100111 

39 

$27 


Closing quote 



> 

0101000 

40 

$28 

( 



( 

( 

0101001 

41 

$29 

) 



) 

) 

0101010 

42 

$2A 

* 



* 

★ 

0101011 

43 

$2B 

+ 



+ 

+ 

0101100 

44 

$2C 

) 

Comma 


> 

> 

0101101 

45 

$2D 


Hyphen 


- 

- 

0101110 

46 

$2E 


Period 


. 

, 

0101111 

47 

$2F 

/ 



/ 

/ 

0110000 

48 

$30 

0 



0 

0 

0110001 

49 

$31 

1 



1 

1 

0110010 

50 

$32 

2 



2 

2 

0110011 

51 

$33 

3 



3 

3 

0110100 

52 

$34 

4 



4 

4 

0110101 

53 

$35 

5 



5 

5 

0110110 

54 

$36 

6 



6 

6 

0110111 

55 

$37 

7 



7 

7 

0111000 

56 

$38 

8 



8 

8 

0111001 

57 

$39 

9 



9 

9 

0111010 

58 

$3A 




: 

; 

0111011 

59 

$3B 

> 



J 

5 

0111100 

60 

$3C 

< 



< 

< 

0111101 

61 

$3D 

= 



= 

= 

0111110 

62 

$3E 

> 



> 

> 

0111111 

63 

$3F 

? 



7 
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Table H-7. Uppercase Characters, High Bit Off 


ASCII 


Binary 

Dec 

Hex 

Char 

Interpretation 

What to Type 

Pri 

Alt* 

1000000 

64 

$40 

@ 



@ 

fk 

1000001 

65 

$41 

A 



A 

d 

1000010 

66 

$42 

B 



B 

k 

1000011 

67 

$43 

C 



C 

X 

1000100 

68 

$44 

D 



D 


1000101 

69 

$45 

E 



E 

a 

1000110 

70 

$46 

F 



F 

* 

1000111 

71 

$47 

G 



G 


1001000 

72 

$48 

H 



H 

<r 

1001001 

73 

$49 

I 



I 

M| 

1001010 

74 

$4A 

J 



J 

4, 

1001011 

75 

$4B 

K 



K 

1 

1001100 

76 

$4C 

L 



L 


1001101 

77 

$4D 

M 



M 

♦J 

1001110 

78 

$4E 

N 



N 

■ 

1001111 

79 

$4F 

O 



O 

> 

1010000 

80 

$50 

P 



P 


1010001 

81 

$51 

Q 



Q 


1010010 

82 

$52 

R 



R 


1010011 

83 

$53 

S 



S 

— 

1010100 

84 

$54 

T 



T 

L 

1010101 

85 

$55 

U 



U 


1010110 

86 

$56 

V 



V 

m 

1010111 

87 

$57 

W 



W 

m 

1011000 

88 

$58 

X 



X 

c 

1011001 

89 

$59 

Y 



Y 

n 

1011010 

90 

$5A 

Z 



Z 

1 

1011011 

91 

$5B 

[ 

Opening bracket 


[ 

♦ 

1011100 

92 

$5C 

\ 

Reverse slant 


\ 

__ 

1011101 

93 

$5D 

] 

Closing bracket 


J 

JL 

nr 

1011110 

94 

$5E 


Caret 


* 

3 

1011111 

95 

$5F 


Underline 




1 


* If the high bit is set, the MouseText characters are replaced with their equivalent in the primary character set with that value. 
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Table H-8. Lowercase Characters, High Bit Off 


ASCII 


Binary 

Dec 

Hex 

Char 

Interpretation 

What to Type 

Pri 

Alt 

1100000 

96 

$60 

- 

Opening quote 



- 

1100001 

97 

$61 

a 



/ 

a 

1100010 

98 

$62 

b 



n 

b 

1100011 

99 

$63 

c 



# 

c 

1100100 

100 

$64 

d 



$ 

d 

1100101 

101 

$65 

e 



% 

e 

1100110 

102 

$66 

f 



& 

f 

1100111 

103 

$67 

g 



’ 

g 

1101000 

104 

$68 

h 



( 

h 

1101001 

105 

$69 

i 



) 

i 

1101010 

106 

$6A 

j 



* 

j 

1101011 

107 

$6B 

k 



+ 

k 

1101100 

108 

$6C 

1 




1 

1101101 

109 

$6D 

m 



- 

m 

1101110 

110 

$6E 

n 




n 

1101111 

111 

$6F 

0 



/ 

0 

1110000 

112 

$70 

P 



0 

P 

1110001 

113 

$71 

q 



1 

q 

1110010 

114 

$72 

r 



2 

r 

1110011 

115 

$73 

s 



3 

s 

1110100 

116 

$74 

t 



4 

t 

1110101 

117 

$75 

u 



5 

u 

mono 

118 

$76 

V 



6 

V 

1110111 

119 

$77 

w 



7 

w 

1111000 

120 

$78 

X 



8 

X 

1111001 

121 

$79 

y 



9 

y 

1111010 

122 

$7A 

z 




z 

1111011 

123 

$7B 

{ 

Opening brace 


; 

{ 

1111100 

124 

$7C 

1 

Vertical line 


< 

1 

1111101 

125 

$7D 

} 

Closing brace 



} 

1111110 

126 

$7E 


Overline (tilde) 


> 


1111111 

127 

$7F 

DEL 

Delete/rubout 


? 

DEL 
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Firmware Listings 
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Appendix I is a listing of the source code for the Monitor, enhanced video 
firmware, and input/output firmware contained in the version of the 
Apple lie that supports UniDisk 3.5. 

If you find that you absolutely must develop software or hardware for an 
original Apple lie that will not be upgraded in the future, you can get a 
listing of the old source code by filling out and mailing the order form in the 
back of this manual. 
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SOURCE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 

INCLUDE 


FILE #01 
FILE #02 
FILE #03 
FILE #04 
FILE #05 
FILE #06 
FILE #07 
FILE #08 
FILE #09 
FILE #10 
FILE #11 
FILE #12 
FILE #13 
FILE #14 
FILE #1S 
FILE #16 
FILE #17 
FILE #18 
FILE #19 
FILE #20 
FILE #21 
FILE #22 
FILE #23 
FILE #24 
FILE #25 
FILE #26 
FILE #27 
FILE #28 
FILE #29 


>FIRM 
>NAMES 
>EQUATES 
>SERI AL 
>SER 
>COMM 
>C3SPACE 
>MOUSE 
>MCODE 
>MISC 
>BOOT 
>SWITCHER 
> IRQBUF 
1 >M I N I 

1 > SCROLL I NG 
1 >ESCAPE 
1 >PASCAL 
1 >MOREM I SC 

■ > AUTOST 1 

■ > AUT0ST2 

■ >BANK2 
■>MINT 
■>AUXSTUFF 
■>BANGER2 

■ >SWI TCHER2 
•>COMMAND 

• >MBAS I C 
*>BANGER 

■ >VECTORS2 


CO 


oo 




01 FIRM 
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0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 


0000 


F80 0 


INCLUDE FILE #02 
C 1 00 : 

C 1 00 : 


2 x6S02 

3 

4 * 

5 • Firmware for the Apple lie 

6 • 

7 * December, 1983 

8 * 

9 * 

10 * Rich Williams 

11 • Ernie Beernink 

12 * James R Huston 

13 • 

14 • Revision 2 May, 1985 

15 • rom expanded to 32K in 2 16K banks 

16 * new features added: 

17 • Protocol converter slot 5 

18 * AppleTalk slot 7 

19 • //e diagnostics 

20 * Enhanced serial port commands 

21 • Mini assembler 

22 • Step and trace 

23 * most $F8 rom changes marked with a ♦ 

24 * 

25 

26 F80RG EQU 0F800 

>NAMES 

29 1st on 

30 include equates {Equates for Video 


t Monitor ROM 






03 EQUATES 


Apple //c Video Firmware 
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C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C 1 0 0 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
0100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
0100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 
C 1 0 0 
C100 
0100 
C100 
C100 
C100 
C100 
C100 
C100 
C100 


0044 

0045 

0046 

0047 

0048 

0049 
004E 
004F 


0006 

009S 

009B 


0200 


03F0 

03F2 

03F4 

03F5 

03F8 

03FB 

03FE 

0400 

07F8 


C000 
C000 
C000 
C001 
C002 
C003 
C004 
C005 
C008 
C009 
C00C 
C00D 
C00E 
C00F 
C010 
C01 1 
C012 
0013 
C014 
C016 
C018 
C019 
C0 1 A 
C01B 
C01C 
C01D 
C01E 
C01F 
C028 
C030 
C050 
C05 1 

0052 

0053 

0054 


73 • 

74 MACSTAT EQU *44 {Machine state after BRK 

75 ACC EQU *45 ;Acc after BRK 

76 * 

77 XREG EQU *46 ;X reg after break 

78 YREG EQU *47 ;Y reg after break 

79 STATUS EQU *48 ;P reg after break 

80 SPNT EQU *49 ;SP after break 

81 RNDL EQU *4E ;random counter low 

82 RNDH EQU *4F {random counter hiqh 

83 • a 

84 • Value equates 

85 • 

86 G00DF8 EQU *06 {value of //e, lolly ID byte 

87 PICK EQU *95 {C0NTR0L-U character 

88 ESC EQU *9B ;what ESC generates 

89 • 3 

90 * Characters read by GETLN are placed in 

91 * IN, terminated by a carriaqe return. 

92 * 

93 IN EQU *0200 {input buffer for GETLN 

94 • 

95 • Page 3 vectors 

96 * 

97 BRKV EQU *03F0 {vectors here after break 

98 SOFTEV EQU *03F2 {vector for warm start 

99 PWREDUP EQU *03F4 {THIS MUST » EOR **AS OF S0FTEV+1 

100 AMPERV EQU *03F5 {APPLESOFT & EXIT VECTOR 

101 USRADR EQU *03F8 {APPLESOFT USR function vector 

102 NMI EQU *03FB ;NMI vector 

103 IRQLOC EQU 103FE {Maskable Interrupt vector 

104 LINE1 EQU *0400 {first line of text screen 

105 MSLOT EQU *07F8 {owner of *C8 space 

106 • y 

107 • HARDWARE EQUATES 

108 • 


109 IOADR EQU *C000 

110 KBD EQU *C000 

111 CLR80COL EQU *C000 

112 SET80COL EQU *C001 

113 RDMAINRAM EQU *C002 

114 RDCARDRAM EQU *C003 

115 WRMAINRAM EQU *C004 

116 WRCARDRAM EQU *C005 

117 SETSTDZP EQU *C008 

118 SETALTZP EQU «C009 

119 CLR80VID EQU *C00C 

120 SET80VID EQU *C00D 

121 CLRALTCHAR EQU *C00E 

122 SETALTCHAR EQU *C00F 

123 KBDSTRB EQU *C010 

124 RDLCBNK2 EQU *C011 

125 RDLCRAM EQU *C012 

126 RDRAMRD EQU *C013 

127 RDRAMWRT EQU *C014 

128 RDALTZP EQU *C016 

129 RD80COL EQU *C018 

130 RDVBLBAR EQU *C019 

131 RDTEXT EQU *C01A 

132 RDM I X EQU *C01B 

133 RDPAGE2 EQU *C01C 

134 RDHIRES EQU *C01D 

135 ALTCHARSET EQU *C01E 

136 RD80VID EQU *C01F 

137 ROMBANK EQU *C028 

138 SPKR EQU *C030 

139 TXTCLR EQU *C0S0 

140 TXTSET EQU *C051 

141 MIXCLR EQU *C0S2 

142 MIXSET EQU *C053 

143 TXTPAGE 1 EQU *C0S4 


for IN* , PR* vector 

>127 if keystroke 

disable 80 column store 

enable 80 column store 

read from main 48K RAM 

read from alt. 48K RAM 

write to main 48K RAM 

write to alt. 48K RAM 

use main zero page/stack 

use alt. zero page/stack 

disable 80 column hardware 

enable 80 column hardware 

normal LC, flashing UC 

normal inverse, LC ; no flash 

turn off key pressed flag 

>127 if LC bank 2 is in 

>127 if LC RAM read enabled 

>127 if reading main 48K 

>127 if writing main 48K 

>127 if Alt ZP and LC switched in 

>127 if 80 column store 

>127 if not VBL 

>127 if text tnot graphics) 

>127 if mixed mode on 

>127 if TXTPAGE2 switched in 

>127 if HIRES is on 

>127 if alternate char set in use 

>127 if 80 column hardware in 

Switches r ombank s 

clicks the speaker 

switch in graphics Cnot text) 

switch in text Cnot graphics) 

clear mixed-mode 

set mixed-mode (4 lines text) 

switch in text page 1 



03 EQUATES 

Appl 

e // c Video Firmware 

26- JUL-85 PAGE 5 

03 EQUATES 

App 

e //c Video Firmware 
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C100 

C0S5 

144 

TXTPAGE2 

EQU 

*0055 

{switch in text page 2 

0100 

0004 

215 

M.VMGDE 

EQU 

*04 


C100 

0056 

145 

LORES 

EQU 

*0056 

; low-resolution graphics 

0100 


216 

* 




C100 

0057 

146 

HIRES 

EQU 

*0057 

; high-r eso lu 1 1 on graphics 

0100 

0478 

217 

ROMSTATE 

EQU 

*478 

;temp store of ROM state 

C 1 0 0 

0058 

147 

CLRAN0 

EQU 

*0058 


0100 

04F8 

218 

TEMPI 

EQU 

*4F8 

; used by CTLCHAR 

C100 

0059 

148 

SETAN0 

EQU 

*0059 


0100 

0578 

219 

TEMPA 

EQU 

$578 

{used by scroll 

C100 

C05A 

149 

CLRAN1 

EQU 

(C05A 


0100 

0SF8 

220 

TEMPY 

EQU 

*5F8 

;used by scroll 

C100 

C05B 

150 

SETAN1 

EQU 

• C05B 


0100 


221 

# 




C100 

C05C 

151 

CLRAN2 

EQU 

*0050 


0100 

047B 

222 

QLDCH 

EQU 

$478*3 

; last value of CH 

C100 

C05D 

152 

SETAN2 

EQU 

*C05D 


0100 

057B 

223 

□ URCH 

EQU 

$578*3 

; 80 - COL CH 

C100 

C05E 

153 

CLRAN3 

EQU 

*C05E 


0100 

05FB 

224 

OURCV 

EQU 

$5F8*3 

{CURSOR VERTICAL 

C100 

C05F 

154 

SETAN3 

EQU 

*C05F 


0100 

067B 

225 

VFACTV 

EQU 

$678*3 

;Blt7*video firmware inactive 

C100 

0060 

155 

RD40SUI 

EQU 

*0060 

; > 1 2 7 if 40/80 switch in 40 pos 

0100 

06FB 

226 

XCOORD 

EQU 

$6F8*3 

{X-COORD (GOTOXY) 

C100 

0061 

156 

BUTN0 

EQU 

*0061 

;open apple key 

0100 

077B 

227 

NXTCUR 

EQU 

$778*3 

{next cursor to display 

C100 

0062 

157 

BUTN1 

EQU 

*0062 

; c 1 osed apple key 

0100 

07FB 

228 

CURSOR 

EQU 

$7F8+3 

; the current cursor char 

C100 

0064 

158 

PADDL0 

EQU 

*0064 

;read paddle 0 

0100 


229 

# 




C100 

0070 

159 

PTRIG 

EQU 

*0070 

{trigger the paddles 

0100 


230 

* Disk II 

boo t 

rom equates 


C100 

0081 

160 

ROM I N 

EQU 

*0081 

{switch in *D000-*FFFF ROM 

0100 


231 

# 




C100 

0083 

161 

LCBANK2 

EQU 

*0083 

;switch in LC bank 2 

0100 

0356 

232 

DNIBL 

EQU 

$356 


C100 

C08B 

162 

LCBANK1 

EQU 

*C08B 

jswitch in LC bank 1 

0100 

0300 

233 

NBUF1 

EQU 

$300 


C100 

CFFF 

163 

CLRR0M 

EQU 

*CFFF 

; swl tch out *08 ROMs 

0100 

002B 

234 

SLOTZ 

EQU 

$2B 


C100 

E000 

164 

BASIC 

EQU 

*E000 

; BAS I C entry point 

0100 

0030 

235 

BOOTTMP 

EQU 

$30 


C100 

E003 

165 

BAS 1 02 

EQU 

*E003 

;BASIC warm entry point 

C100 

004F 

236 

BOOTDEV 

EQU 

$4F 


C100 


166 

• 











C100 

04FB 

167 

VM0DE 

EQU 

•4F8*3 

; 0PERAT I NG MODE 








C100 


168 

• 











C100 


169 

• BASIC VMODE 

BITS 


0100 


238 





C100 


170 





0100 


239 

• Entry p 

olnts 

for other modules 

C100 


171 

• 1 

. - 

3ASIC active 


0100 


240 





C100 


172 

• 0 

. - 

3 ascal active 


0100 

0880 

241 

pcnv 

equ 

$0880 


C100 


173 

• .0 




0100 

C5FS 

242 

boot f ai 1 

equ 

$C5F5 

{Boot fails message 

C 1 00 


174 

• .1 




0100 

C5F8 

243 

pcnvr st 

equ 

$C5F8 

{Protocol converter reset 

C100 


175 

• . .0 

. - 

°r i nt control 

characters 

0100 

0580 

244 

ata 1 k 

equ 

$0580 

; Apple talk 

C100 


176 

• . . 1 

. - 

Don't print ctrl chars 

0100 


31 


Include serial 

{Equates for serial code 

C100 


177 

• . . .0. . . 

. - 










C100 


178 

• . . . 1 . . . 

. - 










0100 


179 

• 0. . 

. - 

3 rint control 

characters 








C100 


180 

• 1 . . 

. - 

Don't print ctrl chars. 








C100 


181 

• 0 . 

. - 










C100 


182 

• 1 . 

. - 










C100 


183 

• 0 

. - 










C100 


184 

• 1 

. - 










C100 


185 


0 - 

Print mouse characters 








C100 


186 


1 - 

Don't print mouse characters 








C100 


187 












C100 

0040 

188 

M . 40 

EQU 

*40 









C100 

0020 

189 

M.CTL2 

EQU 

*20 

; Do n't print controls 








C100 

0008 

190 

M.CTL 

EQU 

*08 

; Don' t print controls 








C100 

0001 

191 

M. MOUSE 

EQU 

*01 

;Don't print mouse chars 








C100 


192 












C100 


193 

• Pascal 

Mode 

Bits 









C100 


194 












C100 


195 

• 1 

. - 

BASIC active 









C100 


196 

• 0 

. - 

Pascal active 









C100 


197 

• -0 











C100 


198 

• .1 











C 1 00 


199 

• . .0 

. - 










C100 


200 

• . . 1 

„ - 










C100 


201 

• . . .0. . . 

. - 

Cursor always 

on 








C100 


202 

• . . . 1 . . . 

. - 

Cursor always 

off 








C100 


203 

• 0- . 

. - 

GOTOXY n/a 









C100 


204 

• 1 . . 

. - 

GOTOXY in progress 








C100 


205 

• 0. 

. - 

Normal Video 









C 1 0 0 


206 

• 1 . 

. - 

Inverse Video 









C100 


207 

• 0 

. - 










C100 


208 

• 1 

. - 










C100 


209 


0 - 

Print mouse chars 








C100 


210 


1 - 

Don't print mouse chars 








C100 


211 












0100 

0080 

212 

M. PASCAL 

EQU 

*80 

{Pascal active 








C100 

0010 

213 

M. CURSOR 

EQU 

*10 

; Don ' t print cursor 








C 1 00 

0008 

214 

M.GOXY 

EQU 

*08 

; GOTOXY IN PROGRESS 









CO 

oo 

CO 
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04 SERIAL 

CO 

° Cl 00: 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 0 0 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C100 : 

C 1 00 : 

C 1 00 : 

C 1 0 0 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

Cl 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

Cl 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C100 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

Cl 00: 

C 1 00 : 

C 1 0 0 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 

C 1 00 : 


C100 

C200 

00BF 

00DF 

008A 

0091 

0093 

03B8 

0438 
04B8 
0538 
05F9 
05F A 
0679 
067A 
0638 
06B8 
0738 
047E 
04FF 
0S7F 
05FF 

067F 

06FF 

0800 

06F8 


BFF8 

BFF9 

BFFA 


3 

4 

5 

6 

7 

8 
9 

10 
1 1 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 


Apple Lolly communications driver 
By 

Rich Williams 
August 1983 

November 5 - J.r.huston 


Command codes 

Default command char is ctrl-A C*A) 

“AnnB: Set baud rate to nn 
“AnnD: Set data format bits to nn 
“AI: Enable video echo 

*AK : Disable CRLF 

*AL : Enable CRLF 

“AnnN: Disable video echo 4 set printer width 
“AnnP: Set parity bits to nn 
*AQ Quit terminal mode 
“AR Reset the ACIA, IN'0 PR*0 
“AS Send a 233 ms break character 
“AT Enter terminal mode 
AZ: Zap control commands 

“Ax: Set command char to “x 

AnnCR:Set printer width CCR ■ carriage return) 

New commands added in rev 1 E - enable D ■ Disable 

*AC E/D Column overflow 
*AL E/D Linefeed same as L 4 K 
“AM E/D Mask Incoming linefeeds 
“AX E/D Xon Xoff handshaking 
“AF E/D Find keyboard 


42 serslot equ 

43 comslot equ 

44 msb 

45 cmdcur equ 

46 termcur equ 

47 msb 

48 lfeed equ 

49 xon equ 

50 xoff equ 

51 sermode equ 


0C 1 00 
4C200 
ON 
• ? • 

OFF 

$8A 

♦ 91 

♦ 93 

♦ 3B8 


52 astat 

53 pwdth 

54 extint 

55 extint2 

56 typhed 

57 oldcur 

58 oldcur2 

59 eschar 

60 flags 

61 col 

62 number 

63 aciabuf 

64 twser 

65 twkey 


equ 0438 
equ 04B8 
equ 0538 
equ 05F9 
equ 05FA 
equ 0679 
equ 067A 
equ 0638 
equ 06B8 
equ 0738 
equ 047E 
equ 04FF 
equ 057F 
equ 05FF 


66 trser equ 067F 

67 trkey equ 06FF 


68 thbuf equ 0800 

69 temp equ 06F8 

70 charbuf equ 0SFE 


71 sdata equ 0BFF8 

72 sstat equ 0BFF9 

73 scomd equ 0BFFA 


; Cur sor while in command mode 
{Cursor while in terminal mode 

{Linefeed 
{XON character 
;XOFF character 

;D7“1 if in command D6“ 1 if terminal 
♦479 4 047A 

{ Acia status from int 4F9 4 4FA 
{Printer width 579 4 57A 
; ext int 4 typhed enable 5F9 4 5FA 


{Saves cursor while in command 
{Saves cursor while in terminal mode 
{Current escape character 6F9 4 6FA 
;D7 - Video echo D6 - CRLF 779 4 77A 
{Current printer column 7F9 4 7FA 
{Number accumulated in command 
{Owner of serial buffer 
{Storage pointer for serial buffer 
{Storage pointer for type ahead 
buffer 

{Retrieve pointer for serial buffer 
{Retrieve buffer for type ahead 
buffer 

{Buffer in alt ram space 
Temp storage 

5FE, 67E are one byte character 
buffers 

♦0N0*090 is output port 
ACIA status register 
ACIA command register 


04 SERIAL 

C 1 00 : 

C 1 0 0 : 


Serial 4 Communications equates 26-JUL-85 PAGE 8 

BFFB 74 sent 1 equ 4BFFB ;ACIA control register 

32 include ser {Printer port § 0C100 



05 SER 


Serial output port routine 
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;Set V to indicate initial entry 
{Always taken 
; Input entry point 
; BCC opcode 

;V * 0 since not initial entry 
{Always taken 

; pasca 1 slgnlture byte 
{device slgnlture 


;Save the reg 
; X - Cn 

;Set ms lot, etc 
;Only output allowed 
; Reset the hooks 
; A - flags 
;Get char 

{Formatting enabled? 

;Get current horlz position 

{Branch if video echo 

{If CH >- PWIDTH, then CH - COL 


{Must be > col for valid tab 
{Branch if ok 
-.8 or 16? 

{If > forget i t 

{Find next comma cheaply 

{Don't blame me it's Dick's trick 

{Save the new position 

;If ch>- wndwdth go back to start of 


{Go back to left edge 


{Have we exceeded width? 


{Are we tabbing? 

{Space • 2 

;CR • 2 
{C - High bit 
{Shift it into char 
{Out it goes 


{Print the actual char 
{Formatting enabled 

{ In video echo? 

{Check if within 8 chars of right 
edge 

{So BASIC can format output 
{If not within 8, we're done 


05 SER 


Serial output port routl 
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0G COMM Communicati 

^ C200 : 2C 89 Cl 3 

C203 : 70 14 C219 4 

C205 : 38 5 sin 

C20G : 90 6 

C207 : 18 7 sout 

C208 : B8 8 

C209 : 50 0E C219 9 


i port routine 

bit serrts 
bvs entr 
sec 

dfb <90 

clc 

civ 

bvc entr 


C20B : 0 1 
C20C : 31 
C20D: 1 1 
C20E: 13 
C20F : 15 
C210: 17 


11 dfb <01 

12 dfb <31 

13 dfb >p2init 

14 dfb >p2read 

15 dfb >p2wr 1 te 

16 dfb >p2status 


C21 1 : 


18 • Pascal support stuff 


C211:80 8B C19E 20 p2lnit bra plinit 

C213:80 93 C1A8 21 p2read bra plread 

C2 1 5 : 80 9D C1B4 22 p2write bra plwrlte 

C21 7: 80 A2 C1BB 23 p2status bra plstatus 


C2 1 9 : DA 

C2 1 A : A2 C2 

C21C: C21C 

C2 1 C : 5A 

C21D: 48 

C2 1 E : 8E F8 07 

C22 1 : 50 22 C245 

C223 : A5 36 

C225 : 45 38 

C227 : F0 06 C22F 

C229: A5 37 

C22B : C5 39 

C22D : F 0 03 C232 

C22F : 20 B6 C2 

C232 : 8A 

C233 : 45 39 

C235 : 05 38 

C237 : D0 07 C240 

C239 : A9 05 

C23B : 85 38 

C23D : 38 

C23E : 80 05 C245 

C24 0 : A9 07 
C242 : 85 3G 


C244 : 18 

C245 : BD B8 06 

C248 : 89 01 

C24 A : D0 03 C24F 

C24C : 4C 17 Cl 

C24F : 90 FB C24C 

C25 1 : 68 

C252 : 80 28 C27C 

C254 : 3C B8 03 

C257 : 50 1C C275 

C259: 20 8F Cl 

C25C : 80 IE C27C 

C25E : C25E 

C25E : 68 

C25F : 20 70 CC 

C262 : 1 0 IB C27F 

C264 : 20 A9 C7 

C267 : B0 EB C254 

C269 : 29 5F 

C26B : C9 51 

C26D : F 0 04 C273 

C26F : C9 52 

C27 1 : D0 09 C27C 

C273 : A9 98 

C27S.-7A 


25 entr 

26 

27 setup 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 sudodef 

39 sunodef 

40 

41 

42 

43 

44 

45 

46 

47 suout 

48 

49 

50 sudone 

51 

52 

53 comout 

54 commport 

55 

56 

57 noesc 

58 

59 

60 

61 testkbd 

62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 exltX 

73 exitl 


phx 
ldx 
equ 
phy 
pha 
stx 
bvc 
1 da 
eor 


cmp 
beq 
jsr 
txa 
eor 
ora 
bne 
1 da 
s ta 
sec 
bra 
Ida 
sta 
clc 
Ida 
bit 
bne 
Jmp 
bcc 

Ei: 

bit 

bvc 

bra 
equ 
P 1 8 

J*'- 

bol 

jsr 

bcs 

and 

cmp 

beq 

cmp 

bne 

Ida 

p 1 y 


l <comslot 


ms lot 

sudone 

cswl 

kswl 

sudodef 

cswh 

k swh 

sunodef 

def au 1 t 

k swh 
k swl 
suou t 
# >sln 


sudone 

'>sout 

cswl 

flags , x 

'1 

commport 
serpor t 
comout 

terml 
sermode , x 
exitl 
serout2 
terml 
• 

update 

serin 

swcmd 

noesc 

'<Sf 

#'Q' 

exltX 

''R' 

terml 

'<98 
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;Set V to indicate Initial entry 

;Input entry point 
;BCC opcode to skip next byte 
;Output entry point 
5 Mar k not Initial entry 
; Branch around pascal entry stuff 

;pascal signlture byte 
;devlce signlture 


; X - <CN00 


;First call? 

; I f both hooks CN00 setup defaults 


J I f both hooks CN then don't do def 
;since it has already been done 

;Set up defaults 

{ I npu t call? 

;Must be Cn00 
;Fix the input hook 

;C ■ 1 for input call 

;Fix output hook 
; Note C might not be 0 
;C-0 for output 
;Check if serial or comm port 
;Leave flags in a for serport 

; Output? 

;Get the char 
; I nput 

; In terminal mode? 

; If not , return key 
;Out it goes 


;Get current char 
{Update cursor & check keyboard 
;N-0 if no new key 
;Test for command 
; Branch if not 

;upshlft for followlnq tests 
;Qul t? 

;Reset? 

i Go check serial 
; return a CTRL-X 


06 COMM 
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C276 : F A 

C277 : 60 

C278: 18 

C279 : 20 A3 C7 

C27C: C27C 

C27C : 20 4C CC 

C27F : 48 

C280 : 20 D9 C7 

C283 : B0 09 C28E 

C285 : BD B8 06 

C288 : 29 10 

C28A : F 0 D2 C25E 

C28C : 80 F2 C280 

C28E : A8 

C28F : 68 

C290 : 5A 

C291 : 20 B8 C3 

C294 : 68 

C295 : BC 38 06 

C298 : F 0 12 C2AC 

C29A : 09 80 

C29C : C9 91 


C29E : F0 DC C27C 

C2A0 : C9 FF 

C2A2 : F 0 D8 C27C 

C2A4 : C9 92 

C2A6 : F 0 D0 C278 

C2A8 : C9 94 

C2AA : F 0 CD C279 

C2AC : 3C B8 03 

C2AF : 50 C4 C275 

C2B 1 : 20 ED FD 

C2B4 : 80 C6 C27C 

C2B6 : C2B6 

C2B6 : 20 9A CF 

C2B9 : BC 29 C2 


C2BC : 20 7C C3 
C2BF : 48 
C2C0 : 88 

C2C 1 :30 04 C2C7 

C2C3 : C0 03 

C2C5 : D0 F5 C2BC 

C2C7 : 20 9A CF 

C2CA : 68 

C2CB : BC 2B C2 

C2CE : 99 FB BF 

C2D 1 : 68 

C2D2 : 99 FA BF 

C2D5 : 68 

C2D6 : 9D B8 06 

C2D9 : 29 01 

C2DB : D0 02 C2DF 

C2DD : A9 09 

C2DF : 9D 38 06 

C2E2 : 68 

C2E3 : 9D B8 04 

C2E6 : 9E B8 03 

C2E9 : 60 

C2EA : 03 07 

C2EC : 00C 1 

C2EC ; C22B 

C2EC : A0 B0 

C2EE : 0012 

C30 0 : 


Communications port routine 


74 


plx 


75 


rts 


76 

goremote 

clc 


77 

goterm 

jsr 

swst tm 

78 

terml 

equ 

• 

79 


jsr 

showcur 

80 

serin 

pha 


81 

s i nok bd 

jsr 

swread 

82 


bcs 

sidata 

83 


Ida 

flags , x 

84 


and 

'<10 

85 


beq 

testkbd 

86 


bra 

sinokbd 

87 

sidata 

tay 


88 


P 1 a 


89 


phy 


90 


jsr 

storch 

91 


pla 


92 


ldy 

eschar , x 

93 


beq 

s 1 nomod 

94 


ora 

'<80 

95 


cmp 

'xon 

96 


beq 

terml 

97 


cmp 

'<FF 

98 


beq 

terml 

99 


cmp 

'<92 

100 


beq 

goremote 

1 0 1 


cmp 

'<94 

102 


beq 

goterm 

1 03 

5 i nomod 

bl t 

sermode , x 

104 


bvc 

exitl 

105 


Jsr 

cou t 

106 


bra 

terml 

107 

def au 1 t 

equ 

• 

108 


jsr 

move irq 

109 


ldy 

def ldx-<C1 

110 

def loop 

J sr 

ge ta 1 1 

1 1 1 


pha 


112 


dey 


1 13 


bmi 

def f f 

114 


cpy 

'3 

115 


bne 

def loop 

1 16 
117 

def f f 

Jsr 

pla 

move irq 

1 18 


ldy 

devno , x 

1 19 


sta 

sent 1 , y 

120 


pla 


121 


sta 

scomd , y 

122 


pla 


123 


sta 

flags , x 

124 


and 

'1 

125 


bne 

def com 

126 


Ida 

'9 

127 

def com 

sta 

eschar , x 

128 


pla 


129 


sta 

pwdth , x 

130 


stz 

sermode , x 

131 


rts 


132 

def i dx 

dfb 

3,7 

133 

s 1 tdmy 

equ 

<serslot 

134 

devno 

equ 

*-sl tdmy 

1 35 


dfb 

< A0 , <B0 


136 ds < C30 0 - * , < 0 0 

34 include c3space 


{Into remote mode 
{Into terminal mode 

{Get current char on screen 

{Is it ready? 

{Branch if we got data 
{Is keyboard enabled? 

{Branch if enabled 
{Go test acia again 
{Save new input in y for now 

{Save new char on stack 
{Fix the scnen 
{Get the new data 
{If 0, don't modify char 

{Apple loves the high bit 

; I gnore *Q 
{Ignore FF s 

;*R for remote? 

{ for terminal mode? 

{In terminal mode? 

{Return to user if not A - char 
{Onto the screen with it 

{Set up the defaults 
{make sure irq vectors ok 
{Index into alt screen. Table in 
command 

{Get default from alt screen 


{Done if minus 
;0r if 2 

{Jam irq vector into LC 
{Command, control ft flags on stack 

{Set command reg 


{And the flags 

{A - <01 C*A) if comm mode 

{“I for serial port 
{Get printer width 


{Make table for hardware access 


;80 column card § <C300 



07 C3SPACE 

C300 : 

C300 : 

C300 : 

C300 : 

C300: 

C300 :48 
C30 1 : DA 
C302 : 5A 
C303 : 80 12 
C305 : 38 
C306 : 90 
C307: 18 
C308 : 80 1 A 
C30 A : E A 
C30B : 

C30B : 

C30B : 

C30B: 01 
C30C : 88 
C30D: 

C30D : 2C 
C30E : 2F 
C30F : 32 
C310 : 35 
C311: 

C 3 1 1 : 

C31 1 : 

C 3 1 1 : 

C311:4C AF 
C3 1 4 : 4C B5 
C317: 

C317: 

C317: 

C317: 

C31 7 : 

C317: 

C3 1 7 : 20 20 
C3 1 A : 20 BE 
C31D:20 58 
C320 : 7A 
C32 1 : FA 
C322 : 68 
C323: 18 
C324 : 

C324 : B0 03 
C326 : 4C F6 
C329 : 4C IB 
C32C: 

C32C : 4C 41 
C32F : 4C 35 
C332 : 4C C2 
C33S : 4C B1 
C338: 

C338: 

C338 : 

C338: 

C338: 

C338: 

C338: 

C338 : A9 06 
C33A : 

C33A : 

C33A : 

C33A : 

C33A : CD B3 
C33D : F 0 3C 
C33F : 20 60 
C342 : A9 F8 
C344 : 85 37 
C346 : 64 36 
C348 : B2 36 


C317 


C324 


C7 

C7 


CE 

CD 

FC 


C329 

FD 

FD 

CF 

CF 

CE 

CE 


FB 

C37B 

C3 


Communications 

port 

routine 
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2 

3 





4 

5 

• THIS IS 

THE $C3XX ROM SPACE: 


6 

7 

C3ENTRY 

PHA 


save regs 

8 


PHX 



9 


PHY 



10 


BRA 

BASICINIT 

and init video firmware 

1 1 

C3KEYIN 

SEC 


Pascal 1.1 ID by te 

12 


DFB 

$90 

BCC OPCODE (NEVER TAKEN) 

13 

C3C0UT1 

CLC 


Pascal 1.1 ID byte 

14 


BRA 

BASICENT 

->go print/read char 

15 


NOP 



16 

• 




17 

• PASCAL 

.1 FIRMWARE PROTOCOL 

TABLE: 

18 

• 




19 


DFB 

$01 

{GENERIC SIGNATURE BYTE 

20 


DFB 

$88 

{DEVICE SIGNATURE BYTE 

21 

• 




22 


DFB 

> JP I N I T 

{PASCAL INIT 

23 


DFB 

> JPREAD 

{PASCAL READ 

24 


DFB 

> JPWR I TE 

{PASCAL WRITE 

25 


DFB 

> JPSTAT 

{PASCAL STATUS 

26 





27 

• 




28 

• 128K SUPPORT 

ROUTINE ENTRIES 


29 

• 




30 


JMP 

SWAUX 

{MEMORY MOVE ACROSS BANKS 

31 


JMP 

SWXFER 

{TRANSFER ACROSS BANKS 

32 






35 • BASIC I/O ENTRY POINT: 


BASICENT 
BPRINT 
B INPUT 

JPINIT 

JPREAD 

JPWRITE 

JPSTAT 


JSR 

PLY 

PLX 

PLA 

CLC 

BCS 

JMP 

JMP 

JMP 

JMP 

JMP 


HOOKUP 

SET80 

HOME 


BINPUT 

COUTZ 

KEYIN 

PINIT 

PASREAD 

PWRITE 

PSTATUS 


; COPYROM if needed, s 
{setup 80 columns 
;clear screen 

{restore X 
{restore char 
{output a character 

{■>carry me to input 
{print a character 
! get a keystroke 

{pascal init 
{pascal read 
{pascal write 
; pascal status call 


58 

59 


COPYROM is called when the video firmware is 
initialized. If the language card is switched 
in for reading, it copies the F8 ROM to the 
language card and restores the state of the 
language card. 


61 COPYROM LDA 'G00DF8 


*,get the ID byte 


Compare ID bytes to whatever is readable. If it 
matches, all is ok. If not, need to copy. 


CMP 

BEQ 

JSR 

LDA 

STA 

STZ 

C0PYR0M2 LDA 


F8VERSI0N 

ROMOK 

SETROM 

'$F8 

CSWH 

CSWL 

CCSWL) 


{does it match? 


;read ROM, write RAM, 
{from F800-FFFF 


save state 


; ge t a byte 


07 C3SPACE 

C34A : 92 36 

C34C : E6 36 

C34E : D0 F8 C348 

C350 : E6 37 

C352 : D0 F4 C348 

C354: 

C354 : 

C354 : 

C354 : 

C3S4 : 

C354 : DA 
C355 : AE 78 04 
C358 : 3C 81 C0 
C35B : 3C 81 C0 
C35E : F A 
C35F : 60 
C360: 

C360 : 

C360 : 

C360 : 

C360 : 

C360 : 

C360 : DA 

C36 1 : A2 00 

C363 : 2C 11 C0 

C366 : 30 02 C36A 

C368 : A2 08 

C36A : 2C 12 C0 

C36D : 1 0 02 C371 

C36F :E8 

C370 : E8 

C37 1 : 2C 81 C0 

C374 : 2C 81 C0 

C377 : 8E 78 04 

C37A : FA 

C37B : 60 

C37C: 

C37C : 

C37C : 

C37C : 

C37C: 

C37C : AD 13 C0 
C37F : 0 A 
C380 : AD 18 C0 
C383 : 08 
C384 : 8D 00 C0 
C387 : 8D 03 C0 
C38A : B9 78 04 
C38D : 28 

C38E : B0 03 C393 

C390 : 8D 02 C0 
C393 : 1 0 03 C398 

C395 : 8D 01 C0 
C398 : 60 
C399 : 

C399 : 09 80 

C39B : C9 FB 

C39D : B0 06 C3AS 

C39F : C9 El 

C3A 1 : 90 02 C3A5 

C3A3 : 29 DF 

C3A5 : 60 

C3A6 : 

C3A6 : 

C3A6 : 

C3A6 : 

C3A6 : 

C3A6 : 

C3A6 : 

C3A6 : 48 
C3A7 : A9 08 


Communications port routine 
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73 

74 

75 

76 

77 

78 

79 

80 
81 
82 

83 

84 

85 

86 

87 

88 


STA CCSWL) 
INC CSWL 
BNE C0PYR0M2 
INC CSWH 
BNE C0PYR0M2 

• RESETLC resets the 

• determined by SETROM. 

• write enabled. 

RESETLC PHX 

LDX ROMSTATE 
BIT ROM I N , X 
BIT ROM I N , X 
PLX 
RTS 


;and save a byte 


{fall into RESETLC 


{save X 

{get the state 
;set bank & ROM/RAM read 
;set write enable 
{restore X 


language card to the state 

It always leaves the card 


89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 
100 
101 
102 

103 

104 

105 

106 

107 

108 

109 

110 
111 
112 

113 

114 
1 15 
116 
117 
1 18 

119 

120 
121 
122 

123 

124 

125 

126 

127 

128 

129 

130 

131 

132 

133 

134 

135 

136 

137 

138 

139 

140 

141 

142 

143 


• SETROM switches in the ROM for reading, the RAM 

• for writing, and it saves the state of the 

• language card. It does not save the write 

• protect status of the card. 


SETROM 


NOT 1 


NOREAD 


ROMOK 


PHX 

LDX '0 
BIT RDLCBNK2 
BMI NOT 1 
LDX '$8 
BIT RDLCRAM 
BPL NOREAD 
I NX 
I NX 

BIT $C08 1 
BIT SC081 
STX ROMSTATE 
PLX 
RTS 


{save x 

{assume write enab 1 e , ban k 2 , ROMRD 
{is bank 2 switched in? 

•, ->yes 

{indicate bank 1 
; 1 s LC RAM readable? 

{■>no 

{indicate RAM read 

{ROM read 
;RAM write 
{save state 
{restore X 


• GETALT reads a byte from aux memory screenholes. 

• Y is the index to the byte (0-7) Indexed off of 

• address $478. 


GETALT 

LDA 

RDRAMRD 


ASL 

A 


LDA 

PHP 

RD80COL 


STA 

CLR80COL 


STA 

RDCARDRAM 


LDA 

PLP 

$478, Y 


BCS 

GETALT 1 


STA 

RDMA INRAM 

GETALT 1 

BPL 

GETALT2 


STA 

SET80COL 

GETALT2 

RTS 



save state of aux memory 

and of the 80STORE switch 

no 80STORE to get page 1 
pop in the other half of RAM 
read the desired byte 
and restore memory 


UPSHIFT0 ORA 
UPSHIFT CMP 
BCS 
CMP 
BCC 
AND 

X. UPSHIFT RTS 


'$80 

'$FB 

X. UPSHIFT 

'$E 1 

X. UPSHIFT 

'$DF 


{set high bit for execs 


• GETCOUT performs COUT for GETLN . It disables the 

• echoing of control characters by clearing the 

• M.CTL mode bit, prints the char, then restores 

• M.CTL. NOESC is used by the RDKEY routine to 

• disable escape sequences. 


GETCOUT PHA 

LDA 'M.CTL 


{save char to print 
{disable control chars 



CO 17 C3SPACE 

C3A9: 1C FB 04 
C3AC : 68 
C3AD: 20 ED FD 
C3B0:4C 44 FD 
C3B3 : 

C3B3 : 

C3B3 : 

C3B3 : 

C3B3: 

C3B3 : 

C3B3: 

C3B3 : 

C3B3: 

C3B3 : 

C3B3: 

C3B3 : 

C3B3 : 

C3B3 : 

C3B3 : 

C3B3 : 

C3B3 : 20 9D CC 
C3B6 : 80 09 C3C1 
C3B8 : 

C3B8 : 20 9D CC 

C3BB : 24 32 

C3BD : 30 02 C3C1 

C3BF : 29 7F 

C3C1 :SA 

C3C2 : 09 00 

C3C4 : 30 15 C3DB 

C3C6: 48 

C3C7 : AD FB 04 

C3CA : 6A 

C3CB: 68 

C3CC : 90 0D C3DB 

C3CE : 2C IE C0 

C3D 1:10 08 C3DB 

C3D3 : 49 40 

C3D5 : 89 60 

C3D7 : F0 02 C3DB 

C3D9 : 49 40 

C3DB : 2C IF C0 

C3DE : 1 0 19 C3F9 

C3E0 : 48 

C3E 1 : 8D 01 C0 

C3E4 : 98 

C3E5 : 45 20 

C3E7 : 4A 

C3E8 : B0 04 C3EE 

C3EA : AD 55 C0 

C3ED: C8 

C3EE : 96 

C3EF : 4 A 

C3F0 : A8 

C3F 1 : 68 

C3F2 :91 28 

C3F4 : 2C 54 C0 

C3F7 : 7A 

C3F8 : 60 

C3F9 : 

C3F9:91 28 
C3FB : 7A 
C3FC : 60 

C3FD: 0003 

C400 : 


Communications port routine 


144 

145 

146 

147 

148 • 

149 • STOR 

150 * 

151 • STOR 

152 « 

153 • STOR 

154 • 

155 • STOR 

156 • 

157 • If m 

158 • then 

159 • the 

160 * valu 

161 • 

162 • Call 

163 • 

164 STORY 

165 

166 • 

167 STORCH 

168 

169 

170 

171 STORE 

172 

173 

174 

175 

176 

177 

178 

179 

180 
181 
182 

183 

184 

185 STORE 1 


189 

190 

191 

192 

193 

194 

195 ST0RE2 

196 

197 

198 

199 ST0RE3 

200 

201 STORE4 

202 

203 • 

204 ST0RE5 

205 

206 
207 


TRB VMODE ;by clearing M.CTL 

PLA {restore character 

JSR COUT ;and print It 

JMP NOESCAPE ;enable control chars 

STORCH determines loads the current cursor position, 
Inverts the character, and displays It 
STORCHAR Inverts the character and displays It at the 
position stored In Y 

STORY determines the current cursor position, and 
displays the character without inverting it 
STORE displays the char at the position in Y 

If mouse characters are enabled (VMODE bit 0-0) 
then mouse characters ($40-$5F) are displayed when 
the alternate character set is switched In. Normally 
values $40-$5F are shifted to »0-$1F before display. 

Calls to GETCUR trash Y 


STORE 1 

ALTCHARSET 

STORE 1 

#$40 

#$60 

STORE 1 

#$40 

RD80VID 

STORES 


ST0RE2 

TXTPAGE2 


;first, get cursor position 
{normal or inverse? 

; ■ >normal , store it 
;lnverse It 
; save real Y 

5 does char have high bit set? 
{■>yes, don't do mouse check 


restore char 

">no, don't do mouse shift 
no shift If H char set 
-> It Is! 

$40 - $5F ■ >0 - $ 1 f 


{80 columns? 

;*>no, store char 

; save (shifted) char 

;hi t 80 store 

;get proper Y 

C-1 If char in main ram 

;->yes, main RAM 

;else flip in aux RAM 

;do this for odd left, aux byt» 

;dlvlde pos'n by 2 


get (shifted) 
stuff it 


{Equates for the 


08 MOUSE 
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C400 

C400 

C400 

C400 

C400 

C400 

C400 

C400 

C400 


C400 

C400 

C400 

C400 

C400 


C400 
C400 
C400 
C400 
C400 
C400 
C400 
C400 
C400 
C400 
C400 
C400 
C400 
C400 
C400 
C40 0 
C400 
C400 
C400 
C400 
C400 

C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 
C400 : 


C400 

C400 

C400 

C400 

C400 

C400 


2 msb ON 

3 

4 • 

5 • Mouse firmware for the Chels 

6 • 

7 • by Rich Williams 

8 • July, 1983 

9 * 

10 


12 

13 • 

14 • Equates 

15 • 

16 


18 • Input bounds are in scratch area 
®j 7 ® l 9 moutem P equ $478 {Temporary storage 

0478 20 mini equ $478 7 y 

04F8 21 maxi equ $4F8 

0578 22 ml nh equ $578 

05F8 23 maxh equ $5F8 

24 • Mouse bounds in slot 5 screen area 
047D 25 mlnxl equ $47D 

04FD 26 mlnyl equ $4FD 

057D 27 mlnxh equ $S7D 

0SFD 28 minyh equ $SFD 

067D 29 maxxl equ $67D 

06FD 30 maxyl equ $6FD 

077D 31 maxxh equ $77D 

07FD 32 maxyh equ $7FD 

33 * Mouse holes in slot 4 screen area 
IVS Vr- n,0Uxl et l u M7C 5 X position low byte 

ll m ° Uyl equ MFC ;Y Position low byte 

” 7 £ It m ° U * h equ ,57C ! x position high byte 

lilt ll mou y h e 9 u $SFC ;Y position high byte 

067C 38 mouarm equ $67C ;Arm Interrupts from movement or 

bu 1 1 on 

077C 39 moustat equ $77C {Mouse status 

40 * Moustat provides the following 

41 • D7" Button pressed 

42 • D6- Status of button on last read 

43 • D5- Moved since last read 

44 • D4- Reserved 

45 • D3- Interrupt from VBL 

46 • D2- Interrupt from button 

47 • D1- Interrupt from movement 

48 • D0- Reserved 

07FC 49 moumode equ $7FC {Mouse mode 

50 • D7 - 1 if user wants control of mouse interrupts 

51 • D6-D4- Unused ^ 

52 • D3- VBL active 

53 • D2" VBL interrupt on button 

54 • D1* VBL interrupt on movement 

55 • D0- Mouse active 

0020 56 movarm equ $20 

000C 57 vblmode equ $0C 

0004 58 butmode equ $04 ? D2 mask 

0002 59 movmode equ $02 ;D1 mask 


61 • Hardware addresses 

C015 62 mouxint equ $C01S ;D7 ■ x Interrupt 

of I f? mouyi nt equ $C017 ;D7 - y interrupt 

oo vblint e 9 u *C019 { D7 - vbl interrupt 

™ 7 ® £ S loudabl =9“ $C078 {Disable lou access 

C079 66 louenbl equ $C079 {Enable lou access 
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C400 

C048 

67 

mouc lr 

equ 

♦ C048 

;Clear mouse interrupt 

C400: 


2 




C400 

C058 

68 

iou 

equ 

<C058 

;I0U interrupt switches 

C400: 


3 • 




C400 

C058 

69 

moudsbl 

equ 

• C058 

; Di sab 1 e mouse interrupts 

C400: 


4 • Entry 

points 

for mouse 

f i rmwar e 

C400 

C059 

70 

mouenbl 

equ 

*C059 

; Enab 1 e mouse Interrupts 

C400: 


5 • 




C400 

C063 

71 

moubu t 

equ 

*C063 

;D7 - Mouse button 

C400: 


6 




C400 

C066 

72 

moux 1 

equ 

«C066 

;D7 - XI 

C4 0 0:80 

05 C407 

7 mbaslc 

bra 

outent 


C400 

C067 

73 

mouy 1 

equ 

♦ C067 

; D7 - Y 1 

C402: A2 

03 

8 pnull 

ldx 

• 3 


C400 

C070 

74 

vblc lr 

equ 

$C0 70 

;Clear VBL Interrupt 

C4 04 : 60 


9 

rts 


{Null for 

C400 


75 

• 




C4 05 : 38 


10 inent 

sec 


{Signature 

C400 


76 

• Other 

addresses 


C4 06 : 90 


11 

dfb 

*90 


C400 


77 

• 




C407 : 18 


12 outent 

c lc 



C400 

0200 

78 

inbuf 

equ 

*200 

{Input buffer 

C4 08 : 4C 

CF CS 

13 

Jmp 

xmbas i c 

;Go do bas; 

C400 

0214 

79 

binl 

equ 

inbuf *20 

{Temp for binary conversion 

C4 0B : 0 1 


14 

dfb 

*01 

{More signi 

C40 0 

0215 

80 

bi nh 

equ 

inbuf *21 


C40C : 20 


15 

dfb 

*20 


C400 


36 


include mcode 

{Mouse # *C4 00 

C40D: 02 


16 

dfb 

>pnul 1 
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C40E : 02 
C4 0F : 02 
C4 1 0 : 02 
C4 1 1 : 00 
C4 1 2 : 3B 
C413:DC 
C4 14:93 
C4 1 5 : 82 
C4 1 6 : 69 
C4 1 7 : BD 
C4 1 8 : 6B 
C419: 1 A 
C4 1 A : 

C4 1 A : 


dfb 
dfb 
dfb 
dfb 
dfb 
dfb 
dfb 
dfb 
dfb 
dfb 
dfb 
dfb 
>pnu 1 1 
>goxml nt 


>pnul 1 
>pnu 1 1 
>pnu 1 1 

*0 

ixsetmou 
>xmts t int 
>xmread 
>xmclear 
>noer ror 
>xmc lamp 
>xmhome 
> lnltinouse 


; SETMOUSE 
j SERVEMOUSE 
; READMOUSE 
; CLE ARMQUSE 
; POSMOUSE 
5 CLAMPMOUSE 
; HQMEMOUSE 
; I N I TMQUSE 
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C4 1 A : 



32 




C4 1 A : 



33 

• 



C4 1 A : 



34 

• Inltmouse - 

resets the mouse 

C4 1 A : 



35 

• Also clears 

all of the mouse holes 

C4 1 A : 

C4 1 A : 



36 

37 

• note that iou access fires 

pdlstrb & makes mouse happy 








C4 1 A : 


C4 1 A 

39 

inltmouse equ 

• 


C4 1 A : 9C 

7C 

07 

40 

stz 

moustat 

;Clear status 

C41D: A2 

80 


41 

ldx 

'$80 


C41F: A0 

01 


42 

1 dy 

'1 


C421 :9E 

7D 

04 

43 

xrloop s t z 

mi nx 1 , x 

{Minimum - $0000 

C424 : 9E 

7D 

05 

44 

stz 

ml nxh , x 


C427 : A9 

FF 


45 

Ida 

'$FF 

{Maximum - $03FF 

C429 : 9D 

7D 

06 

46 

sta 

maxx 1 , x 


C42C : A9 

03 


47 

1 da 

'03 


C42E : 9D 

7D 

07 

48 

sta 

maxxh , x 


C431 :A2 

00 


49 

ldx 

'0 


C433 : 88 



50 

dey 



C434 : 10 

EB 

C42 1 

51 

bpl 

xr 1 oop 


C436 : 20 

6B 

C4 

52 

Jar 

xmhome 

{Clear the mouse holes 

C439 : A9 

00 


53 

Ida 

'0 

{Fall into SETMOU 


C43B : 



55 





C43B : 



56 





C43B : 



57 

• XSETMOU 

- Sets 

the mouse 

mode to A 

C43B : 



58 





C43B : 



59 





C43B : 


C43B 

60 

xse tmou 

equ 

• 


C43B : AA 



61 


tax 



C43C : 20 

9A 

CF 

62 


jsr 

move i r q 

{Make sure interrupt vector i 

C43F : 8A 



63 


txa 


{Only x preserved by moveirq 

C440 : 8D 

78 

04 

64 


sta 

mou temp 


C443 : 4A 



65 


1 ar 

A 

;D0 ■ 1 if mouse active 

C444 : 0D 

78 

04 

66 


ora 

mou temp 

;D2 ■ 1 if vbl active 

C447 : C9 

10 


67 


cmp 

'$ 1 0 

{If >-$10 then Invalid mode 

C449 : B0 

IF 

C46A 

68 


bcs 

ami nval id 


C44B : 29 

05 


69 


and 

'5 

{Extract VBL & Mouse 

C44D : F0 

01 

C450 

70 


beq 

xsof f 

{Turning it off? 

C44F : 58 



71 


cli 


{If not , lnts active 

C450 : 69 

55 


72 

xsof f 

adc 

'$55 

{Make iou byte C-0 


C452 




74 




C452 




75 




C452 




76 

SET I 01 

- Sets 

the IOU Interrupt modes to A 

C452 




77 

Inputs: A ■ 

Bits to change 

C452 




78 

D7 - 

Y int o 

n falling edge 

C452 




79 

D6 - 

Y int o 

n rising edge 

C452 




80 

DS - 

X int o 

n falling edge 

C452 




81 

D4 • 

X int o 

n rising edge 

C452 




82 

D3 - 

Enable 

VBL int 

C452 




83 

D2 - 

Disable 

VBL int 

C452 




84 

D 1 - 

Enable 

mouse int 

C452 




85 

D0 - 

Di sable 

mouse int 

C452 




86 




C452 




87 




C452 




88 




C452 



C452 

89 

et 1 ou 

equ 

• 

C452 

08 



90 


php 


C453 

78 



91 


sei 

{Don't allow ints while iou 

C454 

8E 

FC 

07 

92 


stx 

moumode 

C457 

8D 

79 

C0 

93 


sta 

louenbl {Enable iou access 

C45A 

A2 

08 


94 


ldx 

'8 

C45C 

CA 



95 siloop 

dex 


C45D 

0 A 



96 


as 1 

A {Get a bit to check 

C45E 

90 

03 

C463 

97 


bcc 

sinoch ;No change if C-0 

C460 

9D 

58 

C0 

98 


sta 

iou ,x {Set it 
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right 


C463 : D0 F7 C45C 99 sinoch bne 
C465 : 8D 78 C0 100 sta 
0468:28 101 pip 
C469 : 1 8 102 noerror clc 
C46A : 60 103 sminvalid rts 


siloop .Any bits left in A? 

ioudsbl ;Turn off iou access 


C46B : 

C46B: 

C46B : 

C46B : 

C46B : 

C46B : C46B 

C46B : A2 80 
C46D : 80 02 C471 

C46F : A2 00 
C47 1 : BD 7D 04 
C474 : 9D 7C 04 
C477 : BD 7D 05 
C47A : 9D 7C 05 
C47D : CA 

C47E : 10 EF C46F 
C480 : 80 0C C48E 


105 

106 * 

107 • XMH0ME- Clears mouse position & status 

108 * 

109 • ** 

1 1 0 xmhome equ * 

111 ldx '$80 {Point mouse 

112 bra xmh2 

113 xmhloop ldx '0 

114 xmh2 Ida minxl,x 

115 sta mouxl ,x 

116 Ida ml nxh , x 

117 sta mouxh , x 

118 dex 

119 bpl xmhloop 

120 bra xmcdone 


to upper left 


C482: 122 

C482: 123 • 

C482 : 124 • XMCLEAR - Sets the mouse to 0,0 

C482 : 125 • 

C482 : 126 

C482 : C482 127 xmclear equ * 

C482 : 9C 7C 04 128 stz mouxl 

C485 : 9C 7C 05 129 stz mouxh 

C488 : 9C FC 04 130 stz mouyl 

C48B : 9C FC 05 131 stz mouyh 

C48E:9C 7C 06 132 xmcdone stz mouarm 

C49 1:18 133 clc 

C492 : 60 134 rts 


:nabled 
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C493 : 



136 





C493 : 



137 





C493 : 



138 

• XMREAD 

- Updat 

es the screen 

ho 1 es 

C493 : 



139 





C493 : 



140 





C493 : 


C493 

141 

xmr ead 

equ 

• 


C493 : A9 

20 


142 


Ida 

#movarm 

;Has mouse moved? 

C495: 1C 

7C 

07 

143 


trb 

mous tat 

{Clear moved bit in stat 

C498 : 2D 

7C 

06 

144 


and 

mouarm 


C49B: 1C 

7C 

06 

145 


trb 

mouarm 

{Clear arm bit 

C49E : 2C 

FC 

07 

146 


bit 

moumode 

;If D7 ■ 1 leave buttons a 

C4A 1 : 30 

13 

C4B6 

147 


bmi 

xmr d2 


C4A3:2C 

63 

C0 

148 


bit 

moubu t 

{Button pressed? 

C4A6 : 30 

02 

C4AA 

149 


bmi 

xr bu t 


C4A8 : 09 

80 


150 


ora 

#$80 


C4AA : 2C 

7C 

07 

151 

xrbu t 

bit 

moustat 

{Pressed last time? 

C4AD : 10 

02 

C4B 1 

152 


bpl 

xrbut2 


C4 AF : 09 

40 


153 


ora 

#$40 


C4B 1 :8D 

7C 

07 

154 

xr bu 1 2 

sta 

mous tat 


C4B4 : 18 



155 


clc 



C4B5 : 60 



156 


rts 



C4B6 : 


C4B6 

157 

xmrd2 

equ 

• 

{Leave button bits alone 

C4B6 : 0D 

7C 

07 

158 


ora 

moustat 


C4B9 : 29 

E0 


159 


and 

#$E0 

{Button bits 

C4BB : 80 

F 4 

C4B 1 

160 


bra 

xrbu t2 



C4BD 

C4BD 

C4BD 

C4BD 

C4BD 

C4BD 




162 

163 

164 

165 

166 
167 

• XMCLAMP - Sto 

• Inputs A ■ 1 

• mini , mlnh 

re new bounds 
for Y, 0 for 
, max 1 , maxh 

X axis 

- new bounds 





1 68 




C4BD 



C4BD 

169 

xmclamp equ 

• 


C4BD 

6A 



170 

ror 

A 

{1 -> 80 

C4BE 

6A 



171 

ror 

A 


C4BF 

29 

80 


172 

and 

#$80 


C4C 1 

AA 



173 

tax 



C4C2 

AD 

78 

04 

174 

Ida 

mini 


C4C5 

9D 

7D 

04 

175 

sta 

minxl , x 


C4C8 

AD 

78 

05 

176 

Ida 

mlnh 


C4CB 

9D 

7D 

05 

177 

sta 

minxh , x 


C4CE 

AD 

F8 

04 

178 

1 da 

maxi 


C4D 1 

9D 

7D 

06 

179 

sta 

maxx 1 , x 


C4D4 

AD 

F8 

05 

180 

Ida 

maxh 


C4D7 

9D 

7D 

07 

181 

sta 

maxxh , x 


C4DA 

18 



182 

clc 


;No error 

C4DB 

60 



183 

rts 



C4DC 




185 




C4DC 




186 

• XMTST I NT - Checks mouse st 

atus bits 

C4DC 




187 

• Used for user 

mouse lnterr 

upt 

C4DC 




188 




C4DC 



C4DC 

189 

xmtstint equ 

• 


C4DC 

48 



190 

pha 



C4DD 

18 



191 

clc 



C4DE 

A9 

0E 


192 

Ida 

#$0E 


C4E 0 

2D 

7C 

07 

193 

and 

moustat 


C4E3 

D0 

01 

C4E6 

194 

bne 

nos ta t2 


C4E5 

38 



195 

sec 



C4E6 

68 



196 

nostat2 pla 



C4E7 

60 



197 

rts 



C4E8 



0013 

198 

ds 

$C4FB- • , 0 


C4FB 

D6 



199 

dfb 

$D6 

{Signature byte 

C4FC 



0004 

200 

ds 

$C500-* ,$00 


C50 0 




37 

i nc lu 

de misc 

{Miscellaneous junl 

C500 



008E 

1 

ds 

$C58E - • ,0 
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C58E : 

C58E : 

C58E : 

C58E : 

C58E : 

C58E : A2 03 

C590 : A0 00 

C592 : 86 3C 

CS94:8A 

C595 : 0 A 

C596 : 24 3C 

C598 : F 0 10 C5AA 

C59A : 05 3C 

C59C : 49 FF 

C59E : 29 7E 

C5A0 : B0 08 C5AA 

C5A2 : 4 A 

C5A3 : D0 FB C5A0 

C5A5 : 98 

C5A6 : 9D 56 03 

C5A9 : C8 

C5AA : E8 

C5AB : 10 E5 C592 
C5AD-.A9 08 
C5AF : 85 27 
C5B 1 : A0 7F 
C5B3 : 60 


CSB4 

C5B4 

C5B4 

C5B4 

C5B4 

C5B4 

C5B4 

C5B4 

C5B7 

C5B8 


C5BB : 

C5BB: 

C5BB: 

C5BB : 

C5BB: 

C5BB : C 1 F 0 F0 EC 


C5C4: 

C5C4: 

CSC4: 

CSC4: 

C5C4: 

C5C4: CSC4 

C5C4 : 20 D0 F8 
C5C7 : 20 53 F9 
C5CA : 85 3A 
C5CC : 84 3B 
C5CE : 60 


C5CF 

C5CF 

CSCF 

C5CF 

C5CF 


C5B4 

B9 00 02 
C8 

4C 99 C3 


3 


5 * MAKTBL - Makes a denibllzing table for the disk II boot 


8 MAKTBL LDX #$03 

9 LDY #0 

10 TBLLOOP STX BOOTTMP 

1 1 TXA 

12 ASL A 

13 BIT BOOTTMP 

14 BEQ NOPATRN 

15 ORA BOOTTMP 

16 EOR #$FF 

17 AND #$7E 

18 TBLL00P2 BCS NOPATRN 

19 LSR A 

20 BNE TBLL00P2 

21 TYA 

22 STA DNIBL.X 

23 INY 

24 NOPATRN INX 

25 BPL TBLLOOP 

26 LDA #$08 

27 STA $27 

28 LDY #$7F 

29 RTS 


31 

32 • 

33 • GETUP - Get char from input buffer 

34 * lny and upshift it 

35 • 

36 

37 getup equ * 

38 Ida in,y ;Get character 

39 1 ny 

40 Jmp upshlft0 


42 

43 • 

44 • This is who we are 9 letters 

45 • 

46 

47 app 1 e2c asc 'Apple //c' 


49 

50 • 

51 • SHOWINST - Disassemble an instruction and adjust the PC 

52 • 

53 

54 showinst equ • 

55 jsr instdsp 

56 Jsr pcadj 

57 sta pci 

58 sty pch 

59 r ts 


61 

62 • 

63 • XMBASIC - Basic call to the mouse 

64 • 

65 
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10 MI SC 

OO 

C5CF : CSCF 66 xmbasic equ • 

C5CF : 5A 67 phy 

C5D0:B0 1C C5EE 68 bcs gobasicln 

C5D2:A0 C4 69 ldy *<mbasic 

C5D4 : C4 39 70 cpy kawh 

C5D6:D0 04 C5DC 71 bne xmbout 

C5D8 : A4 38 72 ldy kswl 

C5DA:F0 12 CSEE 73 beq gobasicln 

C5DC:DA 74 xmbout phx 

CSDD : 48 75 pha 

C5DE : 29 7F 76 and M7F 

C5E0 : C9 02 77 cmp #2 

C5E2 :B0 06 C5EA 78 bge mbbad 

C5E4 : 20 3B C4 79 Jar xsetmou 

C5E7:20 6B C4 80 Jsr xmhome 

C5EA : 68 81 mbbad pla 

C5EB: FA 82 plx 

C5EC : 7A 83 ply 

C5ED : 60 84 rts 

C5EE:4C 9D C7 85 gobasicln Imp swbaslcin 

C5F 1 : 0004 86 ds *C5F5-*,0 

C5F5: 38 include boot 

C5F5 : 000B 1 ds «C600-*,0 


; I nput? 

; I nput from $C400? 


;5ave X too 

;We don't care about high b 
; Only 0 , 1 val id 


;Go to input routine 
;More disk stuff 
; Dl s k II boot e$C600 
; Di s k II in slot 6 


11 BOOT 
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C676 : C9 96 
C678:F0 09 C683 

C67A : 28 

C67B : 90 C2 C63F 
C67D : 49 AD 
C67F :F0 25 C6A6 

C68 1 : D0 BC C63F 

C683 : A0 03 
0685:85 40 
C687 : BD 8C C0 
C68A : 1 0 FB C687 
C68C : 2A 
C68D : 85 3C 
C68F : BD 8C C0 
0692:10 FB C68F 
0694:25 30 
0696:88 

0697 :D0 EC 0685 

0699:28 

C69A : 05 3D 

C69C : D0 A 1 C63F 

C69E : AS 40 

C6A0 : 05 41 

C6A2 : D0 9B C63F 

C6A4 : B0 90 0642 

C6A6 : A0 56 

C6A8 : 84 30 

C6AA : BC 80 00 

C6AD : 1 0 FB C6AA 

C6AF : 59 D6 02 

C6B2 : A4 30 

C6B4 : 88 

C6B5 : 99 00 03 

C6B8 : D0 EE C6A8 

C6BA : 84 30 

C6BC : BC 80 00 

C6BF : 1 0 FB C6BC 

0601:59 D6 02 

C6C4 : A4 30 

0606:91 26 

C6C8 : 08 

C6C9 : D0 EF C6BA 
C6CB : BC 80 00 
C6CE : 1 0 FB C6CB 
C6D0 : 59 D6 02 
C6D3 : D0 CD C6A2 
C6D5 : A0 00 
C6D7 : A2 56 
C6D9 : CA 

C6DA : 30 FB C6D7 

C6DC : B 1 26 

C6DE : 5E 00 03 

C6E 1 :2A 

C6E2 : 5E 00 03 

C6E5 : 2A 

C6E6 : 9 1 26 

C6E8 : 08 

C6E9.-D0 EE C6D9 
C6EB: 

C6EB : 

C6EB: 

C6EB: 

C6EB: 

C6EB : E6 27 

C6ED : E6 3D 

C6EF : A5 3D 

C6F 1 : CD 00 08 

C6F 4 : A6 4F 

C6F6 : 90 DB C6D3 

C6F8 : 40 01 08 

C6FB: 0005 



CO 


CO 


CO 


;Last byte 


ist be 0 
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0700 : 


39 


include switcher 


;Bank switcher 0 $0780 



4 ^ 


CD 


o 
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C70 0 : 


0080 

2 

ds 

$C780- # ,0 









C780 : 



4 • 




C780 : 



5 • Code fo 

r swltchlnq between 

banks 

C780 : 



6 • This co 

de app 

ears in both 

banks of the rom 

C780 : 



7 • 










C780 : 8D 

28 

C0 

9 swrtl 

sta 

rombank 

;RTI to the other bank 

C783 : 4 0 



10 

rtl 



C784 : 8D 

28 

C0 

1 1 swr t s 

sta 

rombank 

;RTS to the other bank 

C787 : 60 



12 swr t sop 

r ts 



C 788 : 8D 

28 

C0 

13 swreset 

sta 

rombank 

;Reset routine 

C78B : 4C 

62 

FA 

14 

jmp 

reset 


C78E : 8D 

28 

C0 

15 

sta 

rombank 

{Interrupt routine 

C791 :2C 

87 

C7 

16 

bit 

swr t sop 

;Set V - 1 for other bank 

C794 : 4C 

04 

C8 

17 

Jmp 

irqent 


C 797 : 8D 

28 

C0 

18 swpcnv 

sta 

rombank 

{Protocol converter 

C79A : 4C 

FI 

C7 

19 

jmp 

swsthk3 

{Jump to sethooks from otl 

C79D : 8D 

28 

C0 

20 swbaslcln 

sta 

rombank 

{Mouse BASIC routines 

C7A0 : 4C 

F6 

C7 

21 

Jmp 

s w z z q 1 3 

{Jump to zzquit from other 

C7A3 : 8D 

28 

C0 

22 swsttm 

sta 

rombank 

{Set terminal mode 

C7A6 : 4C 

FI 

C7 

23 

jmp 

sws t tm3 


C7A9 : 8D 

28 

C0 

24 swcmd 

sta 

rombank 

{Serial port command proc: 

C 7AC : 4C 

06 

C8 

25 

Jmp 

swcmd3 

C7AF : 8D 

28 

C0 

26 swaux 

sta 

rombank 

; Moveaux 

C7B2 : 4C 

4E 

C3 

27 

jmp 

moveaux 


C7B5 : 8D 

28 

00 

28 swxfer 

sta 

rombank 


C7B8 : 4C 

97 

C3 

29 

jmp 

xf er 


C7BB : 8D 

28 

C0 

30 swmlnt 

sta 

rombank 

{Mouse interrupt handler 

C7BE : 4C 

00 

Cl 

31 

Jmp 

mousel nt 

C7C1 :8D 

28 

C0 

32 banqer 

sta 

rombank 


C7C4 : 4C 

A9 

D4 

33 

jmp 

diags 


C7C7 : 8D 

28 

C0 

34 swatalk 

sta 

rombank 

{Jump to appletalk 

C7CA : 4C 

80 

C5 

35 

Jmp 

atal k 

C7CD: 8D 

28 

C0 

36 swser3 

sta 

rombank 

{Jump to serout3 . 

C7D0 : 4C 

4F 

C2 

37 

Jmp 

serout3 


C7D3 : 8D 

28 

C0 

38 swgetst 

sta 

rombank 

{Jump to getstat 

C7D6 : 4C 

AC 

C2 

39 

jmp 

getstat 

C7D9 : 8D 

28 

C0 

40 swread 

sta 

rombank 

{Jump to xrdser 

C7DC : 4C 

C3 

C2 

41 

jmp 

xrdser 

C7DF : 8D 

28 

C0 

42 swgetb 

sta 

rombank 

{Jump to getbuf 

C7E2 : 4C 

F7 

C2 

43 

jmp 

getbuf 

C7E5 : 8D 

28 

C0 

44 swzznm 

sta 

rombank 


C7E8 : 4C 

E 0 

D4 

45 

jmp 

zznm 


C7EB : 8D 

28 

C0 

46 swxfqo 

sta 

rombank 

{Jump to users xfer dest 

C7EE : 6C 

ED 

03 

47 

Jmp 

( $3ED) 


C7F 1:20 

23 

CE 

48 swsthk3 

jsr 

sethooks 


C7F 4 : 80 

8E 

C784 

49 

bra 

swr ts 


C7F6 : 20 

4D 

CE 

50 swzzqt3 

jsr 

zzqui t 


C7F9 : 80 

89 

C784 

51 

bra 

swr ts 


C7FB: 


0004 

52 

ds 

$C7FF - * , 0 


C7FF : 00 



53 

dfb 

0 

{Appletalk version number 

C800 : 



40 

inclu 

de irqbuf 

{Interrupt stuff e$C800 


13 IRQBUF 


Serial t Keyboard buffering 
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aide 

ide 


C800 : 

C800 : 

0800: 

C800 : 

C800 : 

C800 : 

C800 : 

C800 : 

C800 : 

C800 : 

C800 : 

C800 : 

C800 : 

C800 : 

C800 : 

C800 : 

C800 : 

C800 : 

C80 0 : 

C800 : 

C80 0 : 

C800 : 

C800 : 4C 9E Cl 
C803 : C803 

C803 : B8 

C804 : C804 

C804 : 48 
C805 : DA 
0806 : BA 
C807 : 68 
0808:68 
0809:68 
C80A : 9A 
C80B : 5A 
C80C : AE 66 00 
C80F : AC 67 C0 
C8 1 2 : D8 
0813:29 10 
C8 1 5 : C9 10 
C8 1 7 : AD 18 00 
C81A : 2D 1C C0 
08 1 D : 29 80 
C8 1 F : F0 05 C826 

C82 1 : 8D 54 C0 
C824.-A9 4 0 
0826 : 50 02 C82A 
0828:09 01 
C82A : 2C 13 C0 
C82D : 1 0 05 C834 

C82F : 8D 02 C0 
0832:09 20 
C834 : 2C 14 C0 
C837 : 1 0 05 C83E 
0839 : 8D 04 C0 
0830:09 10 


C83E : B0 08 C848 

C840 : 48 
C84 1 : 20 BB C7 
C844 : 90 3C C882 
C846 : 68 
C847 : 18 
C848 : 2C 12 C0 
C84B : 80 03 C850 

C84D : 0000 

C84D : 4C A8 Cl 
C850 : C850 

0850:10 0C C85E 
C852 : 09 0C 
0854:20 11 C0 
0857:10 02 C85B 
C859 : 49 06 


NEMIRQ - The main (only) IRQ handling routine 
IRQENT - Entry point from alternate rom bank 


Thia routine saves the memory atate of the machine, 
checka for an Internal interrupt, and then calla the user 
interrupt handler at $3FE. 

The memory atate la encoded as followa: 

D7 ■ 1 if Alernate zero page / stack 

D6 ■ 1 if 80 store and page 2 

D5 - 1 if Read aux 

D4 - 1 if Write Aux 

D3 - 1 if L.C. enabled 

D2 - 1 if L.C. and $D000 bank 1 

D1 ■ 1 if L.C. and $D000 bank 2 

D0 - 1 if Alternate rom bank 

New changes in the interrupt handler are marked with a ♦ 


NEW I RQ EQU 

CLV 

IRQENT EQU 


'$10 

'$10 

RD80CQL 

RDPAGE2 

'$80 

I RQ2 

TXTPAGE 1 

'$40 

IRQ21 

'01 

RDRAMRD 

IRQ3 

RDMA INRAM 

'$20 

RDRAMWRT 

IRQ4 

WRMAINRAM 
'$10 
I RQ5 


RDLCRAM 
passk ipl 
$C84D- • , $00 
p 1 read 


;Pascal 1.0 Initialization 

V-0 for main bank 
;♦ Entry point from other bank 
assumes V-1 

; ♦ Save A on stack, not $45 
;♦ X too 

;♦ Save stack pointer 
{♦ Skip past X 
;♦ And A 

;♦ Here is the status Oh boy! 
;* Fix the stack pointer 
; Save Y too 
;Get mouse info 
;As soon as we can 
i ♦ No decimal mode please 
; ♦ Test break bit 
;♦ C-1 if break. V unchanged 
{TEST FOR 80-STORE WITH 
; PAGE 2 TEXT. 

; MAKE IT ZERO OR $80 


SET PAGE 2 RESET BIT. 

♦ Which Rombank? 

♦ Mark other bank 

BRANCH IF MAIN RAM READ 
ELSE, SWITCH IT IN 
AND RECORD THE EVENT! 

DO THE SAME FOR RAM WRITE. 


;Branch if break 
; Save machine states so far... 

;♦ Go Test Mouse $ ACIA 
;♦ Branch if it was. LC unchanged! 
;Restore states recorded so far 
; Reset br eak / i nter rupt handler 
; DETERMINE IF LANGUAGE CARD ACTIVE 
;Skip around pascal 1.0 stuff 


70 

71 

72 

73 


ORA '$C 
BIT RDLCBNK2 
BPL I RQ6 
EOR '$6 


SET TWO BITS SO RESTORED 
LANGUAGE CARD IS WRITE ENABLED 
BRANCH IF NOT PAGE 2 OF $D000 
ENABLE READ FOR PAGE 2 ON EXIT 
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C85B:8D 81 C0 74 IRQ6 STA ROM I N 

C85E : 2C 16 C0 75 IRQ7 BIT RDALT2P 

C86 1:10 0D 0870 76 BPL IRQ8 

C863 : BA 77 TSX 

C864 : 8E 01 01 78 STX $101 

C867 : AE 00 01 79 LDX $100 

C86A : 9A 80 TXS 

C86B: 8D 08 C0 81 STA SETSTDZP 

C86E : 09 80 82 ORA '$80 

C870 :B0 35 C8A7 83 IRQ8 BCS GOBREAK 

0872:48 84 PHA 

0873 : A9 08 85 LDA '< I RQDONE 

0875:48 86 PHA 

0876 : A9 7F 87 LDA '> I RQDONE 

0878:48 88 PHA 

0879 :A9 04 89 LDA '4 

C87B : 48 90 PHA 

C87C : 60 FE 03 91 JMP ($3FE) 


LAST... AND VERY IMPORTANT! 

UNLESS IT IS NOT ENABLED 
SAVE CURRENT STACK POINTER 
AT BOTTOM OF STACK 
GET MAIN STACK POINTER 


; SAVE RETURN IRQ ADDR 

; SO WHEN INTERRUPT DOES RTI 
; IT RETURNS TO IRQDONE. 

; PROCESS EXTERNAL INTERRUPT 


C87F : 

C87F : 

C87F : 

C87F : 

C87F : 

C87F : 

C87F : 

C87F : 

C87F : 

C87F : AD 81 00 
0882:68 

0883:10 07 C88C 
0885 : 8D 09 00 
0888 :AE 01 01 
C88B : 9A 
C88C : A0 06 
C88E : 1 0 06 0896 

0890: BE 86 OF 
0893 : FE 00 00 
0896:88 

0897:30 03 C89C 
0899 :0A 

C89A : D0 F2 C88E 

C89C : 0 A 

C89D : 0A 

C89E : 7A 

C89F : F A 


93 • The user's RTI returns here 

94 * BEWARE 

95 • The rom must be reenabled wi 

96 * This way if the LC was write 

97 * if it was write enabled, it 

98 • if it was being write enabl 

99 • The restore loop uses on INC 

read 

100 * and some are write. It must 

6502 and 

101 • the 65C02 do two reads befoi 

reasons) . 

102 IRQDONE LDA ROMIN 

103 IRQLCOK PLA 

104 BPL IRQDN1 

105 STA SETALTZP 

106 LDX $101 

107 TXS 

108 IRQDN1 LDY '$06 

109 IRQDN2 BPL IRQDN3 

110 LDX I RQTBLE , Y 

111 INC $0000, X 

112 IRQDN3 DEY 

113 BMI IRQDN4 

114 ASL A 

115 BNE IRQDN2 

116 IRQDN4 ASL A 

117 ASL A 

118 PLY 

119 PLX 


th a LDA romin 
protected, it still is 
still is 

ed ( 2 Idas), it still will be 
because some of the switches are 

be an INC abs,x since both the 

e the write (for different 

♦ Did some clown bank out the rom? 
{Recover machine state 

Branch if main zp was active 

Restore alternate stack pointer 

♦ Y - index into table of switches 

♦ Branch if no change 

♦ Get soft switch address 

♦ Hit the switch. No page cross!!! 

♦ Branch if all done 
Get next bit to check 

♦ Fall through if all done 

♦ C " 1 if other rom bank 


{RESTORE ALL REGISTERS 


C8A0 : 68 


120 PLA 


C8A 1 : B0 01 C8A4 121 BCS IRQDN5 ;♦ Which rom bank? 


C8A3 : 40 


122 


RTI 


;D0 THE REAL RTI! 


C8A4 : 40 80 07 123 IRQDN5 JMP SWRTI ;♦ Go back to the other bank 


C8A7 : 125 

C8A7 : 126 • 

C8A7: 127 • GOBREAK- If a braek instruction has occurred, we check 

C8A7 : 128 • if the BRK happened in the alternate rom bank. If it has, 

C8A7 : 129 • some fool may have hit the rom switch by accident and the PC is 

C8A7: 130 • decremented by two, the main rom is switched in and we resume 

C8A7: 131 • where we think he wanted to go 

C8A7 : 132 * 

C8A7 : 133 

C8A7 : C8A7 134 GOBREAK EQU • 

CSA 7 : 30 20 C8C9 135 BMI GBBRK {Give up if alt zp 

C8A9:89 09 136 BIT '9 {From alt rom and no lang card? 

C8AB : F 0 1C C8C9 137 BEQ GBBRK ;If not then break 

C8AD:29 FE 138 AND '$FE {Force main rom 

C8AF : 48 139 PHA {Save state 

C8B0 : BA 140 TSX {Save stack pointer 

C8B1 : 68 141 PLA {Skip State 


4^ 

O 
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C8B2 : 68 142 PLA 
C8B3 : 68 143 PLA 
C8B4 : 68 144 PLA 
C8B5 : 68 145 PLA 
C8B6 : 68 146 PLA 
C8B7 : 7A 147 PLY 
C8B8 : 00 01 148 CPY 
C8BA : 90 0B C8C7 149 BCC 
C8BC : E9 02 150 SBC 
C8BE : B0 01 C8C1 151 BCS 
0800:88 152 DEY 
C8C 1 : 5A 153 GBN0C PHY 
0802:48 154 PHA 
C8C3 : 9A 155 TXS 
C8C4 : 40 7F 08 156 JMP 
C8C7 : 9A 157 GBN0TR0M TXS 
0808:68 158 PLA 
C8C9 : 40 47 FA 159 GBBRK JMP 


'$01 

GBN0TR0M 

'2 

GBN0C 


IRQDONE 


NEWBRK 


{Skip Y 
{Skip X 
{Skip A 
{Skip P 
{> address 
{< address 
In the ROM? 

Branch if not 
PC ■ PC - 2 

{Borrow from high byte 
{Push new address 

{Fix stack pointer 

{Fix stock pointer 
{Get state back 
Go do the break 
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C91D: 

C91D: 

C91D: 

C91D: 

C91D: 

C91D: 

C91D: 

C9 1 D : 20 3B CA 

C920 : 84 34 

C922 : DD BA F9 

C925 : D0 13 C93A 

C927 : 20 3B CA 

C92A : DD B4 F9 

C92D : F 0 0D C93C 

C92F : BD B4 F9 

C932 : F 0 07 C93B 

C934 : C9 A4 

C936 : F 0 03 C93B 

C938 : A4 34 

C93A: 18 

C93B : 88 

C93C : 26 44 

C93E : E0 03 

C94 0 : D0 0D C94F 

C942 : 20 A7 FF 

C945 : A5 3F 

C947 : F 0 01 C94A 

C949 : E8 

C94 A : 86 35 

C94C : A2 03 

C94E : 88 

C94F : 86 3D 

C95 1 : CA 

C952 : 1 0 C9 C91D 
C954 : 60 


C955 : 

C955 : 

C955 : 

C955 : 

C955 : E9 81 
C957 : 4 A 

C958 : D0 14 C96E 

C95A : A4 3F 

C95C : A6 3E 

C95E : D0 01 C961 

C960 : 88 

C96 1 : CA 

C962 : 8A 

C963: 18 

C964 : E5 3A 

C966 : 85 3E 

C968 : 1 0 01 C96B 

C96A : C8 

C96B : 98 

C96C : E5 3B 

C96E : D0 57 C9C7 

C970 : 

C970 : 

C970 : 

C970 : A4 2F 
C972 : B9 3D 00 
C975 : 9 1 3A 
C977 : 88 

C978 : 1 0 F8 C972 
C97A : 

C97A : 

C97A : 

C97A : 20 48 F9 


3 

4 

5 

6 

7 

8 


• Apple //c Mini Assembler 

• Got mnemonic, check address mode 


9 

10 AM0D1 JSR NNBL 

1 1 STY YSAV 

12 CMP CHAR 1 , X 

13 BNE AM0D2 

14 JSR NNBL 

15 CMP CHAR2.X 

16 BEQ AM0D3 

17 LDA CHAR2 , X 

18 BEQ AM0D4 

19 CMP #*A4 

20 BEQ AMOD4 

21 LDY YSAV 

22 AM0D2 CLC 

23 AMQD4 DEY 

24 AMQD3 ROL A5L 

25 CPX #*03 

26 BNE AM0D6 

27 JSR GETNUM 

28 LDA A2H 

29 BEQ AMQD5 

30 INX 

31 AM0D5 STX YSAV1 

32 LDX #*03 

33 DEY 

34 AM0D6 STX A 1 H 

35 DEX 

36 BPL AM0D1 

37 RTS 


;get next non-blank 
{save Y 

;get next non-blank 

;done yet? 

;lf ,, * M then done 
{restore Y 

{shift bit into format 

;get high byte of address 


39 * 

40 • 

41 • Calculate offset byte for r 

42 « 

43 REL SBC #*81 

44 LSR A 

45 BNE GDERR 

46 LDY A2H 

47 LDX A2L 

48 BNE REL 1 

49 DEY 

50 REL 1 DEX 

51 TXA 

52 CLC 

53 SBC PCL 

54 STA A2L 

55 BPL REL2 

56 INY 

57 REL2 TYA 

58 SBC PCH 

59 GOERR BNE MINIERR 

60 * 

61 • Move instruction to memory 

62 • 

63 MOVINST LDY LENGTH 

64 M0V1 LDA A1H,Y 

65 STA CPCL) , Y 

66 DEY 

67 BPL MQV1 

68 • 

69 * Display instruction 

70 • 

71 JSR PRBLNK 


elative addresses 
{calc relative address 
;bad branch 


{point to offset 
{displacement - 1 


{subtract current PCL 
;and save as displacement 
{check page 

{get page 
{check page 
{display error 


{get Instruction length 
;get a byte 
;and move it 


{print blanks to make ProDOS 
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C97D : 20 

1 A 

FC 

72 


JSR 

UP 

move up 2 lines 

C980 : 20 

1 A 

FC 

73 


JSR 

UP 


C983 : 


C983 

74 

DISLIN 

EQU 

• 


C983 : 20 

C4 

CS 

75 


JSR 

SHOWINST 

Display line $ get next 

C986 : 


C986 

76 

GETINST1 

EQU 

• 

Get the next instruction 

C986 : A9 

A 1 


77 


LDA 

#$A 1 

! for prompt 

C988 : 85 

33 


78 


STA 

PROMPT 


C98A : 20 

67 

FD 

79 


JSR 

GETLNZ 

Get a line 

C98D : 80 

49 

C9D8 

80 


BRA 

DO INST 

Go do the instruction 

C98F : 



81 

• 




C98F : 



82 

* Compare 

di sas 

sembly of all ki 

town opcodes with 

C98F : 



83 

• the one 

typed 

in until a match is found 

C98F : 



84 

• 




C98F : A5 

3D 


85 

GETOP 

LDA 

A1H 

get opcode 

C99 1 : 20 

8E 

F8 

86 


JSR 

INSDS2 

determine mnemonic index 

C994 : AA 



87 


TAX 


{X - index 

C995 : BD 

00 

FA 

88 


LDA 

MNEMR , X 

get right half of index 

C998 : CS 

42 


89 


CMP 

A4L 

does it match entry? 

C99A : D0 

21 

C9BD 

90 


BNE 

NXTOP 

■>try next opcode 

C99C : BD 

C0 

F9 

91 


LDA 

MNEML.X 

get left half of index 

C99F : 80 

0C 

C9AD 

93 


bra 

plsk ip 

Skip past pascal stuff 

C9A 1 : 


0009 

94 


ds 

$C9AA- • , 0 

Hello I'm the pascal 1.0 








point 

C9AA : 4C 

B4 

Cl 

95 


jmp 

p Iwr i te 

Just getting in the way 


C9AD : C9AD 96 plakip equ 


C9AD: C5 43 

C9AF : D0 0C C9BD 

C9B1 : A5 44 

C9B3 : A4 2E 

C9BS : C0 9D 

C9B7 : F 0 9C C955 

C9B9 : CS 2E 

C9BB: F0 B3 C970 

C9BD : C6 3D 

C9BF.-D0 CE C98F 

C9C 1 : E6 44 

C9C3 : C6 35 

C9C5 : F0 C8 C98F 

C9C7 : 

C9C7 : 

C9C7 : 

C9C7 : 

C9C7 : A4 34 
C9C9 : 98 
C9CA : AA 

C9CB: C9CB 

C9CB : 20 4A F9 
C9CE : A9 DE 
C9D0 : 20 ED FD 
C9D3 : 20 3A FF 
C9D6 : 80 AE C986 
C9D8 : 

C9D8: 

C9D8 : 

C9DB: 

C9D8 : 

C9D8 : 20 C7 FF 
C9DB: AD 00 02 
C9DE : C9 A0 
C9E0 : F0 12 C9F4 
C9E2 : C9 8D 
C9E4.-D0 01 C9E7 
C9E6 : 60 
C9E7 : 

C9E7 : 20 A7 FF 
C9EA : C9 93 
C9EC : D0 DB C9C9 

C9EE : 8A 

C9EF : F 0 D8 C9C9 

C9F 1 : 


CMP A4H 
BNE NXTDP 
LDA A5L 
LDY FORMAT 

CPY #$9D 
BEQ REL 
CMP FORMAT 
BEQ MOVINST 
NXTOP DEC A1H 

BNE GETOP 
INC A5L 
DEC YSAV1 
BEQ GETOP 

• Point to the error with 

• Into the mini-assembler. 

MIN I ERR LDY YSAV 


does it match entry? 

■>no, try next opcode 
found opcode, check address mode 
get addr . mode format for that 
opcode 

is it relative? 

■>yes, calc relative address 
does mode match? 

■>yes, move instruction to memory 

else try next opcode 

■>go try it 

else try next format 

■>go try next format 


;get position 


nput. If pr 
do monitor 
re decoding 


JSR GETNUM 
CMP #$93 
BNE ERR2 
TXA 

BEQ ERR2 


;Beep cause we're mad 
;try again 


:faced with " ", decode 
:ommand. Otherwise parse 


clear mode 

get first char in line 
if blank, 

->go attempt disassembly 
is it return? 

■>no, continue 

else return to Monitor 

parse hexadecimal input 
look for "ADDR:" 
no display error 

X nonzero if address entered 
no “ADDR", display error 




— 


CO 
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C9F 1:20 78 FE 

C9F 4 : A9 03 

C9F6 : 85 3D 

C9F8 : 20 3B CA 

C9FB : 0A 

C9FC : E9 BE 

C9FE : C9 C2 

CA00 : 90 C7 C9C9 

CA02 : 

CA02 : 

CA02 : 

CA02 : 0 A 
CA03 : 0 A 
CA04 : A2 04 
CA06 : 0 A 
CA07 : 26 42 
CA09 : 26 43 
CA0B : CA 

CA0C : 10 F8 CA06 

CA0E : C6 3D 

CA 1 0 : F0 F 4 CA06 

CA 1 2 : 10 E4 C9F8 

CA 1 4 : A2 05 

CA 16 : 20 ID C9 

CA 1 9 : A5 44 

CA IB: 0A 

CA 1 C : 0 A 

CA 1 D : 05 35 

CA IF : C9 20 

CA2 1 : B0 06 CA29 

CA23 : A6 35 

CA25 : F 0 02 CA29 

CA27 : 09 80 

CA29 : 85 44 

CA2B : 84 34 

CA2D : B9 00 02 

CA30 : C9 BB 

CA32 : F 0 04 CA38 

CA34 : C9 8D 

CA36 : D0 B4 C9EC 

CA38 : 4C 8F C9 


CA3B: 

CA3B: 

CA3B : 

CA3B: 

CA3B : 

CA3B : CA3B 

CA3B : 20 B4 C5 
CA3E : C9 A0 
CA40 : F0 F9 CA3B 
CA42 : 60 


143 

144 DDLIN 

145 

146 NXTCH 

147 

148 

149 

150 

151 • 

152 • Form 

153 • 

154 

155 

156 

157 NXTMN 

158 

159 

160 
161 
162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 AM0D7 

177 

178 

179 

180 
181 
182 


183 AM0D8 


JSR A1PCLP ;move address to PC 

LDA #$03 {get starting opcode 

STA A1H ;and save 

JSR NNBL .get next non-blank 

ASL A {validate entry 

SBC #$BE 

CMP #$C2 

BCC ERR2 ;->flag bad mnemonic 

mnemonic for later comparison 

ASL A 

ASL A 

LDX #$04 

ASL A 

ROL A4L 

ROL A4H 

DEX 

BPL NXTMN 

DEC A1H {decrement mnemonic count 

BEQ NXTMN 

BPL NXTCH 

LDX #$5 {index into address mode tables 

JSR AM0D1 ; do this elsewhere 

LDA A5L {get format 

ASL A 

ASL A 

ORA YSAV1 

CMP #$20 

BCS AM0D7 

LDX YSAV1 .get our format 

BEQ AM0D7 

ORA #$80 

STA A5L {update format 

STY YSAV {update position 

LDA $0200, Y .get next character 

CMP #$BB ; l a it a "•,"? 

BEQ AM0D8 ;->yes, skip comment 

CMP #$8D ;is it carriage return 

BNE G0ERR2 

JMP GETOP {get next opcode 


185 

186 

187 

188 

189 

190 

191 

192 

193 

194 


• NNBL - Gets a non blank character for the mini assembler 


nnbl 




equ • 

Jar getup 
cmp #$A0 
beq nnbl 
r t s 


{Get next upshifted character 
{Blank? 
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CA43 : 
CA43 : 
CA43 : 
CA43 : 



196 

197 

198 

199 

• Step 

and trace routines 

CA43: 


CA43 

200 

201 

step 

equ 

. 

CA43 : 2C 

61 

C0 

202 


bit 

bu tn0 

CA46 : 10 

08 

CA50 

203 


bpl 

xqnob t 0 

CA48 : A2 

07 


204 


ldx 

#7 

CA4A : 20 

A8 

FC 

205 

xqwai t 

Jar 

wait 

CA4D: CA 



206 


dex 


CA4E : D0 

FA 

CA4A 

207 


bne 

xqwai t 

CA50 : 2C 

62 

C0 

208 

xqnob t0 

bit 

butn 1 

CA53 : 30 

51 

CAA6 

209 


bml 

xbr k 

CA55 : 20 

75 

FE 

210 


jsr 

alpc 

CA58 : 18 



211 


clc 


CA59: 20 

0D 

CB 

212 


Jsr 

godsp 

CA5C : 68 



213 


p 1 a 


CA5D : 85 

2C 


214 


sta 

rtnl 

CA5F :68 



215 


p 1 a 


CA60 : 85 

2D 


216 


sta 

r tnh 

CA62 : A2 

08 


217 


ldx 

'<08 

CA64 : BD 

04 

CB 

218 

xqini t 

Ida 

initbl-1 ,) 

CA67 : 95 

3C 


219 


sta 

xqt , x 

CA69 : CA 



220 


dex 


CA6A : D0 

F8 

CA64 

221 


bne 

xqini t 

CA6C : A 1 

3A 


222 


Ida 

(pci ,x) 

CA6E : F 0 

36 

CAA6 

223 


beq 

xbr k 

CA70 : A4 

2F 


224 


ldy 

length 

CA72 : C9 

20 


225 


cmp 

'<20 

CA74 : F0 

4A 

CACB 

226 


beq 

xjsr 

CA76 : C9 

60 


227 


cmp 

'<60 

CA78 : F 0 

36 

CAB0 

228 


beq 

xrts 

CA7A : C9 

4C 


229 


cmp 

'<4C 

CA7C : F0 

4A 

CAC8 

230 


beq 

x Jmp 

CA7E : C9 

6C 


231 


cmp 

'<6C 

CA80 : F0 

47 

CAC9 

232 


beq 

x jmpat 

CA82 : C9 

7C 


233 


cmp 

'<7C 

CA84 : F 0 

5D 

CAE3 

234 


beq 

x Jmpatx 

CA86 : C9 

40 


235 


cmp 

'<40 

CA88 : F0 

22 

CAAC 

236 


beq 

xrti 

CA8A : C9 

80 


237 


cmp 

'<80 

CA8C : D0 

02 

CA90 

238 


bne 

xqntbra 

CA8E : A9 

10 


239 


Ida 

'<10 

CA90 : 29 

IF 


240 

xqntbra 

and 

'< IF 

CA92 : 49 

14 


241 


eor 

'<14 

CA94 : C9 

04 


242 


cmp 

'<04 

CA96 : F 0 

02 

CA9A 

243 


beq 

xq2 

CA98 : B 1 

3A 


244 

xql 

Ida 

(pc 1 ) , y 

CA9A : 99 

3C 

00 

245 

xq2 

sta 

xqt ,y 

CA9D : 88 



246 


dey 


CA9E: 10 

F8 

CA98 

247 


bpl 

xql 

CAA0 : 20 

3F 

FF 

248 


Jsr 

restore 

CAA3 : 4C 

3C 

00 

249 


Jmp 

xqt 

CAA6 : A9 

64 


250 

xbr k 

Ida 

'>mon- 1 

CAA8 : A2 

FF 


251 


ldx 

'<mon- 1 

CAAA : 80 

2D 

CAD9 

252 


bra 

r tnjmp2 

CAAC: 18 



253 

xrti 

clc 


CAAD : 68 



254 


pla 


CAAE : 85 

48 


255 


sta 

status 

CAB0 : 68 



256 

xrts 

pla 


CAB 1 : 85 

3A 


257 


sta 

pc 1 

CAB3 : 68 



258 


pla 


CAB4 : 85 

3B 


259 

pc 1 nc2 

sta 

pch 

CAB6: AS 

2F 


260 

pc i nc3 

Ida 

length 

CAB8 : 20 

56 

F9 

261 


jsr 

pcad J 3 

C ABB : 84 

3B 


262 


sty 

pen 

CABD: 18 



263 


clc 


CABE : 90 

1 1 

CADI 

264 


bcc 

newpcl 

CAC0: 18 



265 

xjsr 

clc 


CAC 1 : 20 

54 

F9 

266 



pcad j 2 


; Open apple - slow step 
{Wait about a second 


;Closed apple - break 
{If user specified an address, 
it 

{Disassemble one instruction 
; At CPCL.H) 

{Adjust to user stack 

{Save return address 

; I ni t XEQ area 


{Special if break 


;Do JSR, RTS, JMP, JMP C), JMP 
RTI 


{Make bra turn into bpl 


{Copy user inst to xeq area 
{Change rel branch 
{displacement to 4 for jmp to b 
;or Jump to nbranch 

{Restore user reg contents 

;Xeq user op from ram 

{Print registers and go to moni 

{Display regs 4 go to monitor 

{Simulate rti by geting status 
stack 

{Then doing rts 
{Pop PC Cnot pc - O! 


{Update Pc by 1 (Len - 0) 
{Update pc by length 
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CAC4 : 5A 267 
CAC5 : 48 268 
CAC6 : A0 02 269 
CAC8 : 18 270 
CAC9 : B1 3A 271 
CACB : AA 272 
CACC : 88 273 
CACD : B 1 3A 274 
CACF : 86 3B 275 
CADI: 85 3A 276 
CAD3 : B0 F3 CAC8 277 
CAD5 : A6 2D 278 
CAD7 : A5 2C 279 
CAD9 : DA 280 
CADA : 48 281 
CADB : A9 27 282 
CADD : 85 24 283 
CADF : 38 284 
CAE0 : 4C 0D CB 285 
CAE3 : 18 286 
CAE4 : A5 3A 287 
CAE6:65 46 288 
CAE8 : 85 3A 289 
CAEA : 90 02 CAEE 290 
CAEC : E6 3B 291 
CAEE: 38 292 
CAEF : 80 D8 CAC9 293 
CAF 1:18 294 
CAF2 : A0 01 295 
CAF 4 : B 1 3A 296 
CAF6 : 20 56 F9 297 
CAF9 : 85 3A 298 
CAFB : 98 299 
CAFC : 38 300 
CAFD : B0 B5 CAB4 301 
CAFF: 20 4A FF 302 
CB02 : 38 303 
CB03 : B0 B 1 CAB6 304 



phy 

pha 

ldy 

'<02 

xjmp 

clc 


x jmpat 

Ida 

(pc 1 ) , y 


tax 

dey 

Ida 

(pel) ,y 

newpcl 

stx 

pch 

sta 

Pd 


bcs 

xjmp 

r tn jmp 

ldx 

r tnh 


Ida 

rtnl 

r tn jmp2 

phx 



pha 

Ida 

'39 


sta 

ch 


sec 

jmp 

godsp 

x jmpatx 

clc 



Ida 

pci 


adc 

xreg 


sta 

pci 


bcc 

x jxnoc 


Inc 

pch 

x J xnoc 

sec 


branch 

bra 

x jmpat 

clc 



ldy 

'<01 


Ida 

(pc 1 ) , y 


J sr 

pcad J3 


sta 

pci 


tya 

sec 

bcs 

pcinc2 

nbrnch 

Jsr 

save 


sec 

bcs 

pcinc3 


{Push pc onto stack for jsr 


{Load pc for jmp, (jmp) Simula 


{Move over 


{JMP C,X> 

Add x to address 


{C - 1 for Indirect Jump 

{Branch taken 
{Add len+2 to PC 


{Normal return from xeq 
;Go update PC 


CB05 : 

CB05 : 

CB05 : 

CB05 : 

CB05 : 

CB05 : 

CB05 : EA 
CB06 : EA 
CB07 : 4C FF CA 
CB0 A : 4C FI CA 


306 

307 

308 

309 

310 

311 

312 

313 

314 

315 


* This is the table that is moved into zero page 

• when stepping and tracing 


initbl nop 
nop 

Jmp nbrnch 
jmp branch 


CB0D : 

CB0D : 

CB0D : 

CB0D: 

CB0D : 

CB0D : 

CB0D : 

CB0D : 

CB0D : CB0D 

CB0D : A5 36 

CB0F : 48 

CB 1 0 : A5 37 

CB12 : 48 

CB 1 3 : A9 F0 

CB 15:85 36 

CB1 7 : A9 FD 

CB19 : 85 37 

CB1B: B0 05 CB22 

CB 1 D : 20 D0 F8 


317 

318 

319 

320 

321 

322 

323 

324 

325 

326 

327 

328 

329 

330 

331 

332 

333 

334 

335 


* GODSP - Saves hooks, calls display routine and fixes 

* C * 0 instruction display 

* C ■ 1 register display 

* used by step and trace 


godsp equ * 

Ida cswl 
pha 

Ida cswh {Save output hook 

pha 

Ida '>cout1 
sta cswl 
Ida '<cout1 
sta cswh 

bcs godreg {Which display? 

jsr instdsp 


hooks 
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CB20 : 80 03 CB25 336 bra goddone 

CB22 : 20 DA FA 337 godreg Jsr rgdspl 

CB25 : 68 338 goddone pla 

CB26 : 85 37 339 sta cswh 

CB28 :68 340 pla 

CB29 : 85 36 341 sta cswl 

CB2B : 60 342 rts 

CB2C : 42 INCLUDE SCROLLING ;More Video stuff e$CB30 


4 ^- 


CD 


Cn 


15 SCROLLING 

CB2C : 0004 

CB30 : 

CB30 : 

CB30 : 

CB30 : 

CB30 : 

CB30 : 

CB30 : DA 

CB3 1 : A2 00 

CB33 : 80 03 CB38 

CB3S : 

CB3S : DA 

CB36 : A2 01 

CB38 : A4 21 

CB3A : 2C IF C0 

CB3D : 1 0 18 CB57 

CB3F : 8D 01 C0 

CB42 : 98 

CB43 : 4A 

CB44 : A8 

CB45 : AS 20 

CB47 : 4A 

CB48 : B8 

CB49 : 90 03 CB4E 
CB4B : 2C Cl CB 
CB4E : 2A 
CB4F : 45 21 
CBS 1 : 4 A 

CB52 : 70 03 CB57 

CB54 : B0 01 CB57 

CB56 : 88 

CB57 : 8C F8 05 

CB5A : AD IF C0 

CB5D : 08 

CB5E : A5 22 

CB60 : E0 00 

CB62 : D0 03 CB67 

CB64 : A5 23 

CB66 : 3A 

CB67 : 

CB67 : 8D 78 05 
CB6A : 20 24 FC 
CB6D: 

CB6D : A5 28 
CB6F : 85 2A 
CB7 1 : A5 29 
CB73 : 85 2B 
CB75 : 

CB75 : AD 78 05 

CB78 : E 0 00 

CB7A : D0 07 CB83 

CB7C : C5 22 

CB7E : F 0 39 CBB9 

CB80 : 3A 

CB8 1:80 05 CB88 

CB83 : 1 A 

CB84 : C5 23 

CB86 : B0 31 CBB9 

CB88: 

CB88 : 8D 78 05 
CB8B : 20 24 FC 
CB8E : AC F8 05 
CB9 1 : 28 
CB92 : 08 

CB93 : 1 0 IF CBB4 
CB95 : AD 55 C0 
CB98 : 98 

CB99: F0 07 CBA2 
CB9B : B 1 28 
CB9D : 9 1 2A 
CB9F : 88 
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4^ 

CBA0 : D0 F9 CB9B 74 BNE SCRLEVEN 

CBA2 : 70 04 CBA8 7S SCRLFT BVS SKPLFT 

CBA4 : B1 28 76 LDA (BASL) , Y 

CBA6 : 9 1 2A 77 STA (BAS2L),Y 

CBA8 : AD 54 C0 78 SKPLFT LDA TXTPAGE 1 

CBAB : AC F8 05 79 LDY TEMPY 

CBAE : B0 04 CBB4 80 BCS SKPRT 

CBB0 : B 1 28 81 SCRLODD LDA (BASL),Y 

CBB2 : 9 1 2A 82 STA (BAS2L),Y 

CBB4 : 88 83 SKPRT DEY 

CBB5 : 1 0 F9 CBB0 84 BPL SCRLODD 

CBB7 : 80 B4 CB6D 85 BRA SCRLIN 

CBB9 : 86 • 

CBB9 : 20 A0 FC 87 SCRL3 JSR CLRLIN 

CBBC : 20 22 FC 88 JSR VTAB 

CBBF : 28 89 PLP 

CBC0 : F A 90 PLX 

CBC 1 : 60 91 SEV1 RTS 


;do all but last even byte 
;odd left edge, skip this byte 


now do main page (odd bytes) 
restore width 

even right edge, skip this by 


;scroll next line 

;clear current line 
;restore original cursor line 
jpull status off stack 
jrestore X 
; done ! ! ! 
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CBC2 : 

CBC2 : 

CBC2 : 

CBC2 : 

CBC2 : 2C IF C0 

CBC5 : 30 13 CBDA 

CBC7 : 9 1 28 

CBC9 : C8 

CBCA : C4 21 

CBCC : 90 F9 CBC7 

CBCE : 60 

CBCF : 

CBCF : DA 

CBD0 : A2 D8 

CBD2 : A0 14 

CBD4 : A5 32 

CBD6 : 29 A0 

CBD8 : 80 17 CBF 1 

CBDA: 

CBDA: DA 
CBDB : 48 
CBDC : 98 
CBDD : 48 
CBDE : 38 
CBDF : E5 21 
CBE 1 : AA 
CBE2 : 98 
CBE3 : 4A 
CBE4 : A8 
CBE5 : 68 
CBE6 : 45 20 
CBE8 : 6A 

CBE9 : B0 03 CBEE 

CBEB : 10 01 CBEE 

CBED : C8 
CBEE: 68 

CBEF : B0 0B CBFC 
CBF 1 : 2C 55 C0 
CBF4 :91 28 
CBF6 : 2C 54 C0 
CBF9 : E8 

CBFA : F0 06 CC02 
CBFC: 91 28 
CBFE : C8 
CBFF : E8 

CC00 : D0 EF CBF 1 
CC02 : FA 
CC03 : 60 
CC04 : 

CC04 : 9C FA 05 
CC07 : 9C F9 05 
CC0A : 60 


93 « 

94 * DOCLR Is called by CLREOL. 

95 * to do a (quick) 40 or 80 c 

96 • 

97 DOCLR BIT RD80VID 

98 BMI CLR80 

99 CLR40 STA (BASL) , Y 

100 INY 

101 CPY WNDWDTH 

102 BCC CLR40 

103 RTS 

104 • 

105 CLRHALF PHX 

106 LDX #$D8 

107 LDY #20 

108 LDA INVFLG 

109 AND #*A0 

110 BRA CLR2 

111 « 

112 CLR80 PHX 

113 PHA 

114 TYA 

115 PHA 

116 SEC 

117 SBC WNDWDTH 

118 TAX 

119 TYA 

120 LSR A 

121 TAY 

122 PLA 

123 EOR WNDLFT 

124 ROR A 

125 BCS CLR0 

126 BPL CLR0 

127 INY 

128 CLR0 PLA 

129 BCS CLR1 

130 CLR2 BIT TXTPAGE2 

131 STA (BASL) , Y 

132 BIT TXTPAGE 1 

133 I NX 

134 BEQ CLR3 

135 CLR1 STA (BASL) , Y 

136 INY 

137 INX 

138 BNE CLR2 

139 CLR3 PLX 

140 RTS 

141 • 

142 CLRPORT STZ TYPHED 

143 STZ EXTINT2 

144 RTS 


It decides whether 
lumn clear to end of line. 

".40 or 80 column clear? 
;">clear 80 columns 


;clear right half of screen 
5 for SCRN48 


;->jump into middle 

; preserve X 

; and blank 

;get count for CH 

; save for left edge check 

; coun t a WNDWDTH- Y- 1 

5 save CH counter 
i dlv CH by 2 for half pages 


", restore original CH 
;get starting page 


.iff WNDLFT odd, starting byte 
> get blank i ty blank 
; s tar t i ng page is 1 (default) 
;else do page 2 

; now do page 1 

;all done 

; forward 2 columns 
; next CH 
;not done yet 
;restore X 
5 and exit 

; di sable typeahead 
; and external interrupts 


odd 
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CC0B : 146 • 

CC0B: 147 * PASINVERT la used by Pascal to display the cursor. Pascal 

CC0B: 148 * normally leaves the cursor on the screen at all times. It 

CC0B: 149 • is fleetingly removed while a character is displayed, then 

CC0B: 150 • promptly redisplayed. CTL-F and CTL-E, respectively, 

CC0B: 151 • disable and enable display of the cursor when printed usim 

CC0B: 152 • the Pascal 1.1 entry point CPWRITE). Screen I/O is 

CC0B: 153 • significantly faster when the cursor is disabled. This 

CC0B : 154 • feature is supported by Pascal 1.2 and later. 

CC0B: 155 • 


CC0B : AD 

FB 

04 

156 

PASINVERT 

LDA 

VMODE 

{Called by pascal to 

CC0E : 29 

10 


157 


AND 

#M. CURSOR 

{display cursor 

CC 1 0 : D0 

0A 

CC1C 

158 


BNE 

I NVX 

{■>cursor off, don't invert 

CC 1 2 : 


CC12 

159 

INVERT 

EQU 

• 


CC 1 2 : 20 

ID 

CC 

160 


JSR 

PICKY 

{load Y and get char 

CC 1 5 : 48 



161 


PHA 



CC 1 6 : 49 

80 


162 


EOR 

#$80 

{FLIP INVERSE/NORMAL 

CC 18 : 20 

B3 

C3 

163 


JSR 

STORY 

{stuff onto screen 

CC 1 B : 68 



164 


PLA 


{for RDCHAR 

CC 1 C : 60 



165 

I NVX 

RTS 



CC1D: 



166 

• 




CC1D: 



167 

• PICK li 

f ts a 

character from the screen in either 

CC1D: 



168 

• 40 or 80 columns from the 

current cursor position. 

CC ID : 



169 

• If the 

al ter 

nate character 

set is switched in. 

CC ID : 



170 

* character co 

des $ 0 - $ 1 F are 

returned as $40-$5F (which 

CC ID : 



171 

• is what 

must 

have been orl 

ginally printed to the location 

CC1D: 



172 

• 




CC ID : 5A 



173 

PICKY 

PHY 


;save Y 

CC 1 E : 20 

9D 

CC 

174 


JSR 

GETCUR 

;get newest cursor into Y 

CC2 1 : AD 

IF 

C0 

175 


LDA 

RD80VID 

;80 columns? 

CC24 : 10 

17 

CC3D 

176 


BPL 

PICK1 

; “>no 

CC26 : 8D 

01 

C0 

177 


STA 

SET80COL 

{force 80STORE if 80 columns 

CC29 : 98 



178 


TYA 



CC2A : 45 

20 


179 


EOR 

WNDLFT 

{C”1 if char in main RAM 

CC2C : 6A 



180 


ROR 

A 

{get low bit into carry 

CC2D : B0 

04 

CC33 

181 


BCS 

PICK2 

;*>store in main memory 

CC2F : AD 

55 

C0 

182 


LDA 

TXTPAGE2 

{else switch in page 2 

CC32 : C8 



183 


INY 


;for odd left, aux bytes 

CC33 : 98 



184 

PICK2 

TYA 


{divide pos'n by 2 

CC34 : 4 A 



185 


LSR 

A 


CC35 : A8 



186 


TAY 


;and use as offset into line 

CC36 : B 1 

28 


187 


LDA 

CBASL) , Y 

{pick character 

CC38 : 8D 

54 

C0 

188 


STA 

TXTPAGE 1 

;80 columns, switch in 

CC3B : 80 

02 

CC3F 

189 


BRA 

PICK3 

;skip 40 column pick 

CC3D : B1 

28 


190 

PICK1 

LDA 

CBASL) , Y 

{pick 40 column char 

CC3F : 2C 

IE 

C0 

191 

PICK3 

BIT 

ALTCHARSET 

{only allow if alt set 

CC42: 10 

06 

CC4A 

192 


BPL 

PICK4 


CC44 :C9 

20 


193 


CMP 

#$20 


CC46 : B0 

02 

CC4A 

194 


BCS 

PICK4 


CC48 : 09 

40 


195 


ORA 

#$40 


CC4A : 7A 



196 

PICK4 

PLY 


{restore real Y 

CC4B : 60 



197 


RTS 



CC4C: 



198 

• 




CC4C: 



199 

• SHOWCUR 

disp 

lays either a 

checkerboard cursor, a solid 

CC4C : 



200 

• rectanc 

le , o 

r the current 

cursor character, depending 

CC4C : 



201 

• on the 

value 

of the CURSOR 

location. 0-inverse cursor. 

CC4C : 



202 

• $FF-che 

ckerb 

oard cursor, a 

nythlng else is displayed 

CC4C : 



203 

• after being 

anded with inv 

erse mask. 

CC4C : 



204 

* 




CC4C : AC 

FB 

07 

205 

SHOWCUR 

LDY 

CURSOR 

;what's my type? 

CC4F : D0 

02 

CC53 

206 


BNE 

NOT I NV 

;->not Inverse 

CC5 1 : 80 

BF 

CC 1 2 

207 


BRA 

INVERT 

{else invert the char (exit) 

CC53: 



208 

• 




CC53: 



209 

* Exit with char in accumula 

tor 

CC53: 



210 

• 




CC53 : 20 

ID 

CC 

211 

NOT I HV 

JSR 

PICKY 

;get char on screen 

CC56 : 48 



212 


PHA 


{preserve it 

CC57 : 8D 

7B 

07 

213 


STA 

NXTCUR 

;save for update 

CC5A : 98 



214 


TYA 


{test for checkerboard 

CC5B : C8 



215 


INY 



CC5C : F0 

0D 

CC6B 

216 


BEQ 

N0TINV2 

{ - >checkerboar d , display it 
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CC5E : 7A 
CC5F : 5A 

CC60 : 30 09 CC6B 

CC62 : AD IE C0 

CC65 : 09 7F 

CC67 : 4A 

CC68 : 2D FB 07 

CC6B : 20 B3 C3 

CC6E : 68 

CC6F : 60 

CC70: 

CC70 : 

CC70 : 

CC70 : 

CC70: 

CC70: 

CC70: 

CC70 : 

CC70 : 

CC70 : 48 

CC71 : E6 4E 

CC73-.D0 IE CC93 

CC75 : AS 4F 

CC77 : E6 4F 

CC79 : 45 4F 

CC7B : 29 10 

CC7D : F 0 14 CC93 

CC7F : AD FB 07 

CC82 : F 0 0F CC93 

CC84 : 5A 

CC85 : 20 ID CC 

CC88 : AC 7B 07 

CC8B : 8D 7B 07 

CC8E : 98 

CC8F : 20 B3 C3 

CC92 : 7A 

CC93 : 68 

CC94 : 20 E6 C8 

CC97 : 1 0 26 CCBF 

CC99 : 4C BD CF 

CC9C 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9D 
CC9F 
CCA2 
CCA4 
CCA7 
CCA9 
CCAB 
CCAD 
CCAD 
CCAD 
CCAD 
CCAD 
CCB0 
CCB3 


A4 24 
CC 7B 04 
D0 03 CCA7 
AC 7B 05 
C4 21 

90 02 CCAD 
A0 00 


8C 7B 05 
2C IF C0 
10 02 CCB7 


PLY 

PHY 

BMI N0TINV2 
LDA ALTCHARSET 
ORA #$7F 
LSR A 

N0TINV1 AND CURSOR 

N0TINV2 JSR STORY 

PLA 
RTS 


{don't need Inverse 
{mask - $7F if alternate 
; character set, 

;$3F if normal char set 
;form char to display 
;and display it 
{restore real char 


• The UPDATE routine Increments the random seed. 

• If a certain value is reached and we are in Apple II 

• mode, the blinking check cursor is updated. If a 

• key has been pressed, the old char is replaced on the 

• screen, and we return with BMI. 

• NOTE: this routine used by COMM firmware!! 


PHA 

INC RNDL 

BNE UD2 

LDA RNDH 

INC RNDH 

EOR RNDH 

AND #$10 {need to update cursor? 

BEO UD2 ; • >no , check for key 

LDA CURSOR {what cursor are we using? 

BEQ UD2 ;->//e cursor, leave alone 

PHY ;♦ Save Y 

JSR PICKY {get the character into A 

LDY NXTCUR {get next character 

STA NXTCUR {save next next character 

TYA 

JSR STORY {and print it 

PLY ; ♦ 

>2 PLA {get real char 

JSR XBITKBD {was a key pressed? 

BPL GETCURX {*>no key pressed 

.RKBD JMP CLRKBD2 {♦ restore old key look for key and 

exit 

NOP Keep code alignedkey 

ON CURSORS. Whenever the horizontal cursor position is 
needed, a call to GETCUR is done. This is the equivalent 
of a LDY CH. This returns the current cursor for II and 
//e mode, which may have been poked as either CH or OURCH. 

It also forces CH and OLDCH to 0 if 80 column mode active. 

This prevents LDY CH, STA CBASL),Y from trashing non screen 
memory. It works Just like the //e. 

All routines that update the cursor's horizontal position 
are here. This ensures that the newest value of the cursor 
is always used, and that 80 column CH is always 0. 

GETCUR only affects the Y register 


{save char 
{update seed 
{check for key 


JSR STORY 

PLY 

PLA 

JSR XBITKBD 
BPL GETCURX 
JMP CLRKBD2 


GETCUR LDY CH 

CPY OLDCH 
BNE GETCUR 1 
LDY OURCH 

GETCUR 1 CPY WNDWDTH 

BCC GETCUR2 
LDY #0 


if CH-OLDCH, then 
OURCH is valid 
■>else CH must have b 
use OURCH 

is the value too big 
->no, fits Just fine 
else force CH to 0 


285 GETCUR2 STY OURCH 

286 BIT RD80VID 

287 BPL GETCUR3 


update real cursor 
80 columns? 

■>no, set all cursors 
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CCB5 : A0 00 
CCB7 s 84 24 
CCB9 : 8C 7B 04 
CCBC : AC 7B 05 
CCBF : 60 
CCC0 : 


Apple //c Video firmware 

288 LDY #0 

289 GETCUR3 STY CH 

290 STY OLDCH 

291 LDY OURCH 

292 GETCURX RTS 

43 INCLUDE ESCAPE 


26- JUL-85 
;yes, peg CH to 0 

;get cursor 
; and fly. . . 
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CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0: 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : 

CCC0 : B9 0C CD 

CCC3 : 5A 

CCC4 : 20 58 CD 

CCC7 : 7A 

CCC8 : C0 08 

CCCA : B0 21 CCED 

CCCC : 

CCCC: 

CCCC: 

CCCC: 

CCCC: 

CCCC: 

CCCC: 

CCCC: 

CCCC : 20 ID CC 

CCCF : 48 

CCD0 : 29 80 

CCD2 : 49 AB 

CCD4 : 20 B3 C3 

CCD7 : 20 E6 C8 

CCDA : 1 0 FB CCD7 

CCDC : 68 

CCDD : 20 99 CC 

CCE0 : 20 9B C3 

CCE3 : A 0 13 

CCE5 : D9 F8 CC 

CCE8 : F 0 D6 CCC0 

CCEA : 88 

CCEB : 1 0 F8 CCES 
CCED: 

CCED: 

CCED: 

CCED: 

CCED: 

CCED : A9 08 
CCEF : 1C FB 04 
CCF 2 : 20 0C FD 
CCF5 : 4C 44 FD 
CCF8 : 

CCF8 : 

CCF8 : 

CCF8 : 

CCF8 : 

CCF8: 

CCF8 : 

CCF8 : 

CCF8 : 

CCF8 : 

CCF8 : 

CCF8 : 

CCF8: 

CCF8 : 


START AN ESCAPE SEQUENCE: 

WE HANDLE THE FOLLOWING ONES: 

9 - HOME & CLEAR 
A - Cursor right 
B - Cursor left 
C - Cursor down 
D - Cursor up 
E - CLR TO EOL 
F - CLR TO EOS 

I, Up Arrow - CURSOR UP (stay escape) 

J, Lft Arrow - CURSOR LEFT (stay escape) 

K, Rt Arrow - CURSOR RIGHT (stay escape) 

M, Dn Arrow - CURSOR DOWN (stay escape) 

4 - GOTO 40 COLUMN MODE 

8 - GOTO 80 COLUMN MODE 
CTL-D- Disable the printing of control chars 
CTL-E- Enable the printing of control chars 
CTL-Q- QUIT (PR#0/IN'0) 

SC3 LDA ESCCHAR , Y ; GET CHAR TO "PRINT" 

PHY ; save index 

JSR CTLCHAR ;execute character 

PLY ; restore index 

CPY #YHI ; I f Y<YHI , stay escape 

BCS ESCRDKEY ;->exlt escape mode 

This is the entry point called by RDKEY iff escapes 
are enabled and an escape is encountered. The next 
keypress is read and processed. If it is a key that 
terminates escape mode, a new key is read by ESCRDKEY. 
If escape mode should not be terminated, NEWESC is 


CLRKBD 

UPSHIFT 

'ESCNUM 

ESCTAB.Y 

ESC3 


get current character 

and save i t 

save invert bit 

make it inverted 

and pop it on the screen 

check for keystroke 

get old char 
restore char, get key 
upshift esc char 
COUNT/ INDEX 
IS IT A VALID ESCAPE? 


; TRY 'EM ALL. . . 


This is initially called by RDCHAR which 
by GETLN to read characters with escapes 


55 ESCRDKEY LDA 

56 TRB 

57 JSR 

58 JMP 


'M.CTL 

VMODE 

RDKEY 

NOESCAPE 


; read char with e 
;got the key, dis 


bits set), are m 
These characters 


ide, the characters in ESCTAB (high) 
spped into the characters in ESCCHAR. 
are then executed by a call to CTLCHAR. 


CTLCHAR looks up a character in the table starting at 
CTLTAB . It uses the current index as an index into th 
table of routine addresses, CTLADR . If the character 
not in the table, a call to VID0UT1 is done in case th 
character is BS , LF , CR, or BEL. 


70 • NOTE: CTLON and CTLOFF are not accessible except through 

71 • and escape sequence 
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CCF8 : 

CCF8: CCF8 

CCF8 : CA 

CCF9 : 88 

CCFA : CD 

CCFB : 8B 

CCFC : 95 

CCFD: 8A 

CCFE : C9 

CCFF : CB 

CD00: 0008 

CD00 : C2 

CD01 :C3 

CD02 : C4 

CD03 : C 1 

CD04 : C0 

CD05 : C5 

CD06 : C6 

CD07 : B4 

CD08 : B8 

CD09 : 9 1 

CD0A : 84 

CD0B : 85 

CD0C : 

CD0C : 0013 

CD0C : 

CD0C : CD0C 

CD0C : 88 

CD0D : 88 

CD0E : 8A 

CD0F : 9F 

CD 1 0 : 9C 

CD 1 1 : 8A 

CD12 :9F 

CD13 :9C 

CD 14:88 

CD 15 : CD 1 5 

CD 15 : 8A 

CD 16 : 9F 

CD 1 7 : 9C 

CD 1 8 : 8C 

CD 19 : 9D 

CD 1 A : 8B 

CD1B:91 

CD 1C : 92 

CD1D:95 

CD1E : 04 

CD 1 F : 05 

CD20 : 

CD20 : 85 
CD21 : 86 
CD22 : 8E 
CD23 :8F 
CD24 : 96 
CD25 :97 
CD26 : 98 
CD27 : 99 
CD28 : 9A 
CD29 : 9B 
CD2A: 

CD2A : 0014 

CD2A : 

CD2A : CD2A 

CD2A : 66 FC 
CD2C : 1 A FC 
CD2E : A0 FB 
CD30 : 58 FC 
CD32 : 9C FC 
CD34 : 42 FC 
CD36 : C0 CD 
CD38 : BE CD 



;high bit on 

; left (stay esc) 

;left arrow (stay esc) 
;down (stay esc) 

;up arrow (stay esc) 
;right arrow (stay esc) 
;down arrow (stay esc) 
;up (stay esc) 

;right (stay esc) 

; left 
; down 
;up 

; right 

; formfeed 

; clear EOL 

;clear EOS 

;40 column mode 

;80 column mode 

; CTL-Q - QUIT 

; CTL -D ; c 1 1 char disable 

;CTL-E ;ctl char enable 


list of escape chars 
J: BS (stay esc) 

<-:BS (stay esc) 

M: LF (stay esc) 

UP : US (stay esc) 

->:FS (stay esc) 

DN: LF (stay esc) 

I: UP (stay esc) 

K: RT (stay esc) 

ESC-B - BS 

list of control characters 

ESC-C - DN 

ESC-D - UP 

ESC-A - RT 

§: Formfeed 

E: CLREOL 

F: CLREOP 

SET40 

SET80 

QUIT 

Disable controls (escape only) 
Enable controls (escape only) 

X. CUR. ON 
X. CUR. OFF 
Normal 
I nver se 
Scroll down 
Scroll up 
mouse chars off 
home cursor 
clear line 
mouse chars on 



home cu 
clear t 
clear t 
set 40 
set 80 


or down 
or up 
i space 

or, clear screen 
end of line 
end of page 
ilumn mode 
ilumn mode 




O 


CO 
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CD3A : 45 CE 
CD3C : 9 1 CD 
CD3E : 95 CD 
CD40 : 89 CD 
CD42 : 8D CD 
CD44 : B0 CD 
CD46 : B7 CD 
CD48 : 30 CB 
CD4 A : 35 CB 
CD4C : 9F CD 
CD4E : A5 CD 
CD50 : A0 FC 
CD52 : 99 CD 
CD54 : 

CD54 : 

CD54 : 

CD54 : 

CD54 : 

CD54: 

CD54: 

CD54 : 

CD54 : 

CD54: 

CD54: 

CD54 : 

CD54 : 

CD54 : 2C Cl CB 
CD57 : 50 
CD58: 

CD58 : B8 
CD59 : DA 
CD5A : 8D F8 04 
CD5D : 20 04 FC 
CD60 : CD F8 04 
CD63 : D0 0A CD6F 
CD65 : A2 14 
CD67 : DD 15 CD 
CD6A : F 0 05 CD71 
CD6C : CA 

CD6D : 1 0 F8 CD67 
CD6F : F A 
CD70 : 60 
CD7 1 : 

CD7 1 : 48 

CD72 : 50 0C CD80 

CD74 : AD FB 04 

CD77 : 29 28 

CD79 : 49 08 

CD7B : F 0 03 CD80 

CD7D : 68 

CD7E : FA 

CD7F : 60 

CD80 : 

CD80 : 8A 
CD81 :0A 
CD82 : AA 
CD83 : 68 
CD84 : 20 A4 FC 
CD87 : FA 
CD88 : 60 
CD89: 

CD89: 

CD89: 

CD89 : 

CD89 : 

CD89: 

CD89: 

CD89 : 

CD89 : A9 10 

CD8B : 80 0E CD9B 

CD8D: 


QUIT {Quit video firmware 

CTLOFF ;disable //e control chars 

CTLON ;enable //e control chars 

X. CUR. ON ; turn on cursor (pascal) 

X. CUR. OFF ;turn off cursor (pascal) 

X.SO {normal video 

X.SI {inverse video 

SCROLLDN ; scroll down a line 

SCROLLUP ; scrol 1 up a line 

MOUSOFF ;disable mouse characters 

HOMECUR ;move cursor home 

CLRLIN {clear current line 

MOUSON {enable mouse characters 


CTLCHAR executes the control character in the 
accumulator. If it is called by Pascal, the character 
is always executed. If it is called by the video 
firmware, the character is executed if M.CTL is set 
and M.CTL2 is clear. 

Note: This routine is only called if the video firmware 
is active. The Monitor ROM calls V1D0UT1 if the video 
firmware is inactive. 


CTLCHAR0 BIT SEV1 

DFB $50 

CTLCHAR CLV 
PHX 

STA TEMP 1 
JSR VID0UT1 
CMP TEMPI 
BNE CTLDONE 
LDX 'CTLNUM 
FNDCTL CMP CTLTAB , X 


CTLG01 

VMODE 

'M.CTL+M.CTL2 

'M.CTL 

CTLG01 


; set V (use M.CTL) 


{Always do control character 
{save X 

{temp save of A 

{try to execute CR, LF , BS , 

{if acc has changed 

{then function done 

{number of CTL chars 

{is it in table 

{■>yes, should we execute? 

{else check next 

{“>try next one 

{restore X 

;and return 

{save A 

{V clear, always do (pascal, 
{controls are enabled iff 
; M.CTL - 1 and 
{ M.CTL2 - 0 
{ ■ > they' re enabled!! 

{restore A 


TXA 

ASL A 

TAX 

PLA 

JSR CTLDO 

PL X 

RTS 


• X. CUR. ON - Allow Pascal cursor display 

• X . CUR . OFF • Disable Pascal cursor display 

• Cursor is not displayed during call, so it will 

• be right when “redisplayed". 

• Note: Though these commands are executed from BASIC, 

• they have no effect on firmware operation. 

X. CUR. ON LDA 'M. CURSOR {clear cursor bit 

BRA CLRIT 


or BEL 


escape) 
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° CD8D : A9 10 

CD8F : 80 10 CDA 1 
CD91 : 

CD9 1 : 

CD91 : 

CD91 : 

CD91 : 

CD91: 

CD9 1 : A9 20 

CD93 : 80 0C CDA 1 

CD95 : 

CD95 : A9 20 

CD97 : 80 02 CD9B 

CD99: 

CD99: 

CD99: 

CD99 : A9 01 
CD9B: 1C FB 04 
CD9E : 60 
CD9F : 

CD9F : 

CD9F : 

CD9F : A9 01 
CDA 1 : 0C FB 04 
CDA4 : 60 
CDA5 : 

CDA5 : 

CDAS: 

CDA5 : 20 E9 FE 
CDA8 : A8 
CDA9 : A5 22 
CDAB : 85 25 
CDAD: 4C 88 FC 
CDB0 : 

CDB0 : 

CDB0 : 

CDB0 : 20 84 FE 

CDB3 : A9 04 

CDB5 : 80 E4 CD9B 

CDB7: 

CDB7: 

CDB7 : 

CDB7 : 20 80 FE 
CDBA : A9 04 
CDBC : 80 E3 CDA 1 
CDBE: 

CDBE: 

CDBE: 

CDBE: 38 

CDBF : 90 

CDC0: 18 

CDC 1 : 2C FB 04 

CDC4 : 1 0 54 CE 1 A 

CDC6: 08 

CDC7 : 20 IB CE 

CDCA : 28 

CDCB : 80 08 CDD5 
CDCD: 

CDCD: 

CDCD: 

CDCD: 

CDCD : 2C IF C0 
CDD0 : 1 0 48 CE 1 A 
CDD2: 

CDD2: 18 

CDD3 : B0 

CDD4 : 38 

CDD5 : 64 22 

CDD7 : 2C 1A C0 

CDDA : 30 04 CDE0 

CDDC : A9 14 


215 X. CUR. OFF LDA #M. CURSOR 

216 BRA SETIT 

217 * 

218 • The control characters othi 

219 • are normally enabled when ' 

220 • They can be disabled and ei 

221 • and ESC-E escape sequences. 

222 • 

223 CTLOFF LDA #M.CTL2 

224 BRA SETIT 

225 • 

226 CTLON LDA #M.CTL2 

227 BRA CLRIT 

228 • 

229 * Enable mouse text by clear] 

230 • 

231 MOUSON LDA #M. MOUSE 

232 CLRIT TRB VMODE 

233 RTS 

234 • 

235 • Disable mouse text by sett] 

236 • 

237 MOUSOFF LDA #M . MOUSE 

238 SETIT TSB VMODE 

239 RTS 

240 • 

241 • EXECUTE HOME: 

242 • 

243 HOMECUR JSR CLRCH 

244 TAY 

245 LDA WNDTOP 

246 STA CV 

247 JMP NEWVTABZ 

248 • 

249 • EXECUTE "NORMAL VIDEO" 

250 • 

251 X.SO JSR SETNORM 

252 LDA #M. VMODE 

253 BRA CLRIT 

254 • 

255 • EXECUTE "INVERSE VIDEO" 

256 • 

257 X.SI JSR SET I NV 

258 LDA #M. VMODE 

259 BRA SETIT 

260 • 

261 • EXECUTE '40COL MODE' or '80 

262 • 

263 SET80 SEC 

264 DFB $90 

265 SET40 CLC 

266 BIT VMODE 

267 BPL SETX 

268 PHP 

269 JSR HOOKITUP 

270 PLP 

271 BRA WIN0 

272 • 

273 • CHK80 is called by PR#0 to 

274 • 80. Otherwise the window is 

275 • 

276 CHK80 BIT RD80VID 

277 BPL SETX 

278 • 

279 WIN40 CLC 

280 DFB $B0 

281 WIN80 SEC 

282 WIN0 STZ WNDTOP 

283 BIT RDTEXT 

284 BMI W I N 1 

285 LDA #20 


;set cursor bit 


•r than CR , LF ,BEL , BS 
'ideo firmware is active, 
tabled using the ESC-D 


{disable control characters 
; by setting M.CTL2 

{enable control characters 
{by clearing M.CTL2 

ng M. MOUSE 


ng M. MOUSE 


{move cursors to far left 
{(probably not needed) 

{and to top of window 

{then set base address, OURCV 


; set INVFLG to IFF 

{then clear Inverse mode bit 


{set INVFLG to $3F 

{then set inverse mode bit 


COL MODE': 

{flag an 80 column window 
{ BCC opcode (never taken) 

{flag a 40 column window 
{but. ..is it pascal? 

{">yes, don't execute 

{save window size 

{COPYROM if needed, set I/O hoi 

;and get 40/80 

;->set window 

convert to 40 if it was 
left ajar. 

{don't set 40 if 
{already 40 

{flag 40 column window 
;BCS opcode (never taken) 

{flag 80 column window 
;set window top now 
{for text or mixed 
;->text 
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:B0 07 CDED 

: 1 0 0A CDF2 

: 20 S3 CE 
: 80 05 CDF2 

: 30 03 CDF2 

: 20 80 CE 
: 20 9D CC 


:B0 06 CE02 
:C9 28 

: 90 02 CE02 
:A9 27 
: 20 EC FE 
:A5 25 
: 20 Cl FB 

: 64 20 

:A9 18 

: 85 23 

:A9 28 

:2C IF C0 

: 1 0 01 CE 1 8 


1 : 2C 7B 06 
: 1 0 11 CE31 
: 20 38 C3 
:A9 05 
: 85 38 
:A9 07 
: 85 36 
:A9 C3 
: 85 39 
: 85 37 


:9C FB 07 
:A9 08 
:2D FB 04 
i:09 81 


i:8D FB 04 
:9C 7B 06 
:8D 0F C0 


:2C FB 04 
: 1 0 FA CE44 
: 20 D2 CD 


286 STA WNDTOP 

287 W I N 1 BIT RD80VID 

288 PHP 

289 BCS WIN2 

290 BPL WIN3 

291 JSR SCRN84 

292 BRA WIN3 

293 WIN2 BMI WIN3 

294 JSR SCRN48 

295 WIN3 JSR GETCUR 

296 TYA 

297 CLC 

298 ADC WNDLFT 

299 PLP 

300 BCS WIN4 

301 CMP #40 

302 BCC WIN4 

303 LDA #39 

304 WIN4 JSR SETCUR 

305 LDA CV 

306 JSR BASCALC 

307 • 

308 WNDREST STZ WNDLFT 

309 LDA #$18 

310 STA WNDBTM 

311 LDA #$28 

312 BIT RD80VID 

313 BPL WIN5 

314 ASL A 

315 WINS STA WNDWDTH 

316 SETX RTS 

317 • 

318 • Turn on video firmware: 

319 • 

320 • This routine is used by BA 

321 * It copies the Monitor ROM 

322 * if necessary: it sets the 

323 * $C30x; it sets all swltche 

324 • 

325 HOOKITUP BIT VFACTV 

326 BPL VIDMODE 

327 HOOKUP JSR COPYROM 

328 SETHOOKS LDA #>C3KEYIN 

329 STA KSWL 

330 LDA #>C3C0UT 1 

331 STA CSWL 

332 LDA #<C3C0UT 1 

333 STA KSWH 

334 STA CSWH 

335 * 

336 • Now set the video firmware 

337 • 

338 VIDMODE STZ CURSOR 

339 LDA #M . CTL 

340 AND VMODE 

341 ORA #M . PASCAL *M . I 

342 • 

343 • Pascal calls here to set i 

344 • 

345 PVMODE STA VMODE 

346 STZ VFACTV 

347 STA SETALTCHAR 

348 QX RTS 

349 * 

350 • QUIT converts the screen f 

351 • sets a 40 column window, a 

352 • hooks (C0UT1 and KEYIN). 

353 • 

354 QUIT BIT VMODE 

355 BPL QX 

356 JSR WIN40 


{■>80: convert if 40 
{■>40: no convert 
;80: convert to 40 
{done converting 
{■>80: no convert 
; 4 0 : convert to 80 
{determine absolute CH 
{in case the window se 
;was different 

;pin to right edge if 
;80 to 40 leaves curso 
{off the screen 


{set new cursor 

{set new base address 

{for left ■ 0 (always) 

{Called by INIT and Pascal 
{and bottom 

{set lef t .width , bot tom 
{set width to 80 if 80 colu 


width 

used by SET40/80 


This routine is used by BASIC lnlt, ESC-4, ESC-8 
It copies the Monitor ROM to the language card 
if necessary; it sets the input and output hooks to 
$C30x{ it sets all switches for video firmware operation 


CURSOR {set 
#M . CTL ; pre 
VMODE 

#M. PASCALS. MOUSE 


VMODE 

VFACTV 

SETALTCHAR 


{don't touch hooks 

{if video firmware already activ 

{Copy ROM to LC? 

{set up $C300 hooks 


olid inverse 
e M. CTL bit 


bits 

o firmware active 
alternate char set 
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CE4D : 20 89 FE 3S7 ZZQUIT JSR SETKBD ;do a IN#0 Cuaed by COMM) 

CE50 : 4C 93 FE 3S8 JMP SETVID ;and a PR#0 
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CE53: 

CE53: 

CE53 : 

CE53 : 

CES3 : 

CE53 : A2 17 
CE55 : 8D 01 C0 
CE58 : 8A 
CES9 : 20 Cl FB 
CE5C : A0 27 
CESErSA 
CESF : 98 
CE60 : 4 A 

CE61 : B0 03 CE66 
CE63 : 2C 55 C0 
CE66 : A8 
CE67 : B 1 28 
CE69 : 2C 54 C0 
CE6C : 7A 
CE6D: 91 28 
CE6F : 88 

CE70 : 10 EC CE5E 
CE72 : CA 

CE73 : 30 04 CE79 
CE75 : E4 22 
CE77 : B0 DF CE58 
CE79 : 8D 00 C0 
CE7C : 80 0C C0 
CE7F : 60 
CE80 : 

CE80 : A2 17 
CE82 : 8A 
CE83 : 20 Cl FB 
CE86 : A0 00 
CE88 : 8D 01 C0 
CE8B : B 1 28 
CE8D : 5A 
CE8E : 48 
CE8F : 98 
CE90 : 4 A 

CE9 1 : B0 03 CE96 

CE93 : 8D 55 C0 

CE96 : A8 

CE97 : 68 

CE98 : 9 1 28 

CE9A : 8D 54 C0 

CE9D : 7A 

CE9E : C8 

CE9F : C0 28 

CEA 1 : 90 E8 CE8B 

CEA3 : 20 CF CB 

CEA6 : CA 

CEA7 : 30 04 CEAD 
CEA9 : E4 22 
CEAB : B0 D5 CE82 
CEAD : 8D 0D C0 
CEB0 : 60 
CEB1 : 


360 

361 

362 

363 

364 


SCRN84 and SCRN48 conver 
WNDTOP must be aet up to 
be done. All regiatera 


t screens between 
indicate the laat 
are trashed. 


40 & 80 
line t< 


cola . 


365 SCRN84 

366 

367 SCR 1 

368 

369 

370 SCR2 

371 

372 

373 

374 

375 SCR3 

376 

377 

378 

379 

380 

381 

382 

383 

384 

385 

386 SCR4 

387 

388 

389 • 


LDX #23 
STA SET80COL 
TX A 

JSR BASCALC 
LDY #39 
PHY 
TYA 

LSR A 
BCS SCR3 
BIT TXTPAGE2 
TAY 

LDA (BASL ) , Y 
BIT TXTPAGE 1 
PLY 

STA (BASL) , Y 
DEY 

BPL SCR2 
DEX 

BMI SCR4 
CPX WNDTOP 
BCS SCR 1 
STA CLR80COL 
STA CLR80VID 
RTS 


;start at bottom of screen 
; a 1 1 ow page 2 access 
icalc base for line 

;start at right of screen 
; save 40 index 

;div by 2 for 80 column index 


;even column. 


-.get 80 
; get 80 
; res tor < 
; get 40 


i ndex 
char 


age 

nde 


do 


page 


2 


;do next 40 byte 
;do next line 
; *>done with setup 
•at top yet? 

;clear 80STORE for 40 columns 
;clear 80VID for 40 columns 


390 SCRN48 

391 SCR5 

392 

393 

394 

395 SCR6 

396 SCR8 

397 

398 

399 

400 

401 

402 SCR7 

403 

404 

405 

406 

407 

408 

409 

410 

411 

412 

413 

414 

415 SCR9 

416 
44 


LDX #23 
TXA 

JSR BASCALC 

LDY #0 

STA SET80COL 

LDA (BASL) , Y 

PHY 

PHA 

TYA 

LSR A 

BCS SCR7 

STA TXTPAGE2 

TAY 

PLA 

STA (BASL) , Y 
STA TXTPAGE 1 
PLY 
INY 

CPY #40 
BCC SCR6 
JSR CLRHALF 
DEX 

BMI SCR9 
CPX WNDTOP 
BCS SCRS 
STA SET80VID 
RTS 

INCLUDE PASCAL 


;start at bottom of screen 
;set base for current line 

; s tar t at left of screen 
;enable page2 store 
;get 40 column char 
;save 40 column index 
;save char 

;div 2 for 80 column index 

; save on pagel 

; get 80 column index 
;now save character 

.flip pagel 

irestore 40 column index 
;move to the right 
;at right yet? 

;->no, do next column 
;clear half of screen 
;else do next line of screen 
;">done with top line 
;at top yet? 

;convert to 80 columns 

;Pascal support stuff 
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^ CEB 1 : AA 

CEB2 : F 0 08 CEBC 
CEB4 : CA 

CEBS : D0 07 CEBE 

CEB7 : 20 E6 C8 

CEBA : 1 0 04 CEC0 

CEBC: 38 

CEBD : 60 

CEBE : A2 03 

CEC0: 18 

CEC 1 : 60 

CEC2 : 

CEC2 : 

CEC2 : 

CEC2 : CEC2 

CEC2 : 09 80 

CEC4 : AA 

CEC5 : 20 54 CF 

CEC8 : A9 08 

CECA : 2C FB 04 

CECD:D0 2B CEFA 

CECF-.8A 

CED0 : 89 60 

CED2:F0 45 CF19 

CED4 : AC 7B 05 

CED7 : 24 32 

CED9 : 30 02 CEDD 

CEDB : 29 7F 

CEDD : 20 Cl C3 

CEE0 : C8 

CEE 1 : 8C 7B 05 

CEE4 : C4 21 

CEE6 : 90 0C CEF4 

CEE8 : 20 60 C3 

CEEB : 20 E9 FE 

CEEE : 20 66 FC 

CEF 1 : 20 54 C3 

CEF 4 :20 0B CC 

CEF7 : A2 00 

CEF9:60 

CEFA: 

CEFA: 

CEFA: 

CEFA: CEFA 

CEFA : 20 0B CC 
CEFD: 8A 
CEFE : 38 
CEFF : E9 A0 
CF0 1 : 2C FB 06 
CF 04 : 30 2A CF30 
CF 06 : 

CF 06 : 

CF06 : 

CF06: CF06 

CF 06 : 8D FB 05 
CF 09 : 20 71 CF 
CF0C : AC FB 06 
CF 0F : 20 AD CC 
CF 1 2 : A9 08 
CF 1 4 : 1C FB 04 
CF 1 7 : 80 DB CEF4 
CF 19: 

CF 19 : 20 0B CC 
CF 1 C : 8A 
CF 1 D : C9 9E 
CF 1 F : F0 08 CF29 
CF21 : 20 60 C3 
CF24 : 20 58 CD 
CF27 : 80 C8 CEF 1 
CF29: 

CF29: 


TAX 

BEQ PIORDY 
DEX 

BNE PSTERR 
JSR XBITKBD 
BPL PNOTRDY 


39 PWRITERET 

40 PWRET 

41 PRET 


#$9E 

STARTXY 

SETROM 

CTLCHAR 

PWRITERET 


is request code - 0? 
■>yes, ready for output 
check for any input 
•>bad request, return er 
test keyboard 
->no keystroked 


{turn on high bit 
; save character 

; SETUP ZP STUFF, don't set ROM 
; ARE WE DOING GOTOXY? 

;*>Doing X or Y? 

; now check for control char 
;is it control? 

{■>yes, do control 
;get horizontal position 
;check for inverse 
{normal, go store it 

; now store it (erasing cursor) 
; INC CH 


{set cursor position to 0 


{display new cursor 
{return with no error 


{turn off cursor 
;get character 

{MAKE BINARY 
{doing X? 

•,->yes, set it 


;calc base addr 

{set proper cursors 
{turn off gotoxy 

{ - >DONE (ALWAYS TAKEN) 


is it gotoXY? 

■ >yes , start it up 
must switch in ROM for control 
EXECUTE IT IF POSSIBLE 
->display new cursor, exit 


START THE GOTOXY SEQUENCE 
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CF29: 

CF29 : CF29 

CF29 : A9 08 
CF2B: 0C FB 04 
CF2E : A9 FF 
CF30 : 8D FB 06 
CF33 : 80 BF CEF4 
CF35 : 

CF35 : 

CF35 : 

CF35 : 20 54 CF 
CF38 : 20 D5 C8 
CF3B: 10 FB CF38 
CF3D : 29 7F 
CF3F : 80 B6 CEF7 
CF4 1 : 

CF4 1 : 

CF4 1 : 

CF4 1 : CF4 1 

CF4 1 : A9 01 
CF 43 : 20 3B CE 
CF46 : 20 51 CF 
CF 49 : 20 D4 CD 
CF4C : 20 58 FC 
CF4F : 80 A0 CEF 1 
CF5 1 : 

CF51 : CF5 1 

CF5 1 : 20 60 C3 
CF54 : 64 22 
CF56 : 20 0A CE 
CF59 : A9 FF 
CF5B : 85 32 
CF5D : A9 04 
CFSF : 2C FB 04 
CF62 : F 0 02 CF66 
CF64 : 46 32 
CF66 : AC 7B 05 
CF69 : 20 AD CC 
CF6C : AD FB 05 
CF6F : 85 25 
CF7 1 : 

CF7 1 : 

CF7 1 : 

CF7 1 : 

CF71 :0A 
CF72 : A8 
CF73 : 4A 
CF74 : 4A 
CF75 : 29 03 
CF77 : 09 04 
CF79 : 85 29 
CF7B : 98 
CF7C : 6A 
CF7D: 29 98 
CF7F : 85 28 
CF81 :0A 
CF82 : 0A 
CF83 : 04 28 
CF85 : 60 
CF86 : 


74 • 

75 STARTXY EQU « 

76 LDA "M.GOXY 

77 TSB VMODE 

78 LDA MFF 

79 PSETX STA XCOORD 

80 BRA PWRET 

81 • 

82 • PASCAL INPUT: 

83 • 

84 PASREAD JSR PSETUP2 

85 GKEY JSR XRDKBD 

86 BPL GKEY 

87 AND #$7F 

88 BRA PRET 

89 • 

90 • PASCAL INITIALIZATION: 

91 • 

92 PINIT EQU • 

93 LDA #M. MOUSE 

94 JSR PVMODE 

95 JSR PSETUP 

96 JSR WIN80 

97 JSR HOME 

98 BRA PWRITERET 

99 • 

100 PSETUP EQU • 

101 JSR SETROM 

102 PSETUP2 STZ WNDTOP 

103 JSR WNDREST 

104 LDA #$FF 

105 STA INVFLG 

106 LDA #M . VMODE 

107 BIT VMODE 

108 BEQ PS 1 

109 LSR INVFLG 

110 PS 1 LDY OURCH 

1 1 1 JSR GETCUR2 

112 LDA OURCV 

113 STA CV 

114 • 

115 * Put BASCALC here so we don' 

116 • in the ROMs for each charac 

117 • 

118 PASCALC ASL A 

119 TAY 

120 LSR A 

121 LSR A 

122 AND #*03 

123 ORA #$4 

124 STA BASH 

125 TYA 

126 ROR A 

127 AND #$98 

128 PASCLC2 STA BASL 

129 ASL A 

130 ASL A 

131 TSB BASL 

132 RTS 

45 Include moremlsc 


turn on gotoxy 
set XCOORD to -1 
set X 

->display cursor and exit 


SETUP ZP STUFF 
key pressed? 
->not yet 
DROP HI BIT 
good exit 


{Set mode to pascal 

{without mouse characters 

{setup zero page for pascal 

;do 40->80 convert 

{home and clear screen 

{display cursor, set OURCH , OURCV .. . 


{save LC state, set ROM read 
;set top to 0 

;init either 40 or 80 window 
{assume normal text 

{is it 

; ■ >yes 

; no , make flag inverse 
{set all cursors 


: have to switch 
:er output. 


{calc base addr in BASL,H 
{for given line no. 

; 0<-l lne no. <-$17 
; ar g- 000ABCDE , generate 
; BASH-00000 1CD 
; and 

; BASL-EABAB000 


{More random Junk 




4-*- 

OO 
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CFD5 : 4C 90 FF 65 ]mp nxtbit -Go shift it in 

CFD8 : 4C 8A FF 66 ladlg mp diq 

CFDB : 4C A7 FF 67 lacr mp qetnum 

CFDE : 60 68 ladone rts 

CFDF : 0021 46 ds JD000-* 0 

NEXT OBJECT FILE NAME IS FIRM.1 
F800: F800 47 ORG F80RG 

F800: 48 INCLUDE AUT0ST1 ;F8 monitor rom 



^ 19 AUTOST 1 

4 ^ 

F800 : 4A 

F80 1 : 08 

F802 : 20 47 F8 

F805 : 28 

F806 : A9 0F 

F808 : 90 02 F80C 

F80A : 89 E0 

F80C : 85 2E 

F80E : B 1 26 

F810:45 30 

F812:25 2E 

F8 1 4 : 5 1 26 

F816: 91 26 

F818:60 

F819: 

F819: 20 00 F8 

F8 1 C : C4 2C 

F8 1 E : B0 11 F83 1 

F820 : C8 

F82 1:20 0E F8 

F824 : 90 F6 F81C 

F826 : 69 01 

F828 : 48 

F829 : 20 00 F8 

F82C : 68 

F82D: CS 2D 

F82F : 90 F5 F826 

F83 1 : 60 

F832 : 

F832 : A0 2F 

F834 : D0 02 F838 

F836 : A0 27 

F838 : 84 2D 

F83A : 

F83A : A0 27 
F83C : A9 00 
F83E : 85 30 
F840 : 20 28 F8 
F843 :88 

F844 : 1 0 F6 F83C 

F846:60 

F847 : 

F847 : 48 

F848 : 4A 

F849 : 29 03 

F84B : 09 04 

F84D : 85 27 

F84F : 68 

F850 : 29 18 

F852 : 90 02 F856 

F854 : 69 7F 

F856 : 85 26 

F8S8 : 0A 

F859 : 0A 

F85A : 05 26 

F85C : 85 26 

F85E :60 

F85F : 

F85F : A5 30 
F86 1 : 18 
F862 : 69 03 
F864 : 29 0F 
F866 : 85 30 
F868 : 0A 
F869 : 0A 
F86A : 0A 
F86B : 0A 
F86C : 05 30 
F86E : 85 30 
F870 : 60 
F87 1 : 


Apple //c F8 i 


18 HLINE 

19 HLINE1 


24 VLINEZ 

25 VLINE 


'<0F 

RTMASK 

'<E0 

MASK 

CGBASL), Y 

COLOR 

MASK 

CGBASL), Y 
CGBASL), Y 


34 CLRTOP 

35 CLRSC2 
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; Y-C00RD/2 
; SAVE LSB IN CARRY 
; CALC BASE ADR IN GBASL.H 
; RESTORE LSB FROM CARRY 
; MASK <0F IF EVEN 

; MASK SF0 IF ODD 

; DATA 

; XOR COLOR 
; AND MASK 
; XOR DATA 

; TO DATA 


; PLOT SQUARE 
-.DONE? 

; YES, RETURN 

; NO, I NCR INDEX CX-COORD) 
; PLOT NEXT SQUARE 
{ALWAYS TAKEN 
; NEXT Y-COORD 
; SAVE ON STACK 
; PLOT SQUARE 

; DONE? 

; NO, LOOP. 


;MAX Y, FULL SCRN CLR 
; ALWAYS TAKEN 
; MAX Y, TOP SCRN CLR 
; STORE AS BOTTOM COORD 
FOR VLINE CALLS 
; R I GHTMOST X-COORD CCOLUMN) 
; TOP COORD FOR VLINE CALLS 
; CLEAR COLOR CBLACK) 

-.DRAW VLINE 

{ NEXT LEFTMOST X-COORD 
; LOOP UNTIL DONE. 


; FOR INPUT 00DEFGH 


{GENERATE GBASH-00000 1 FG 
; AND GBASL-HDEDE000 


{INCREMENT COLOR BY 3 


{SETS COLOR* 17*A MOD 16 

{BOTH HALF BYTES OF COLOR EQUAL 
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F871 :4A 
F872 : 08 
F873 : 20 47 F8 
F876:B1 26 
F878 : 28 

F879 : 90 04 F87F 

F87B : 4A 

F87C : 4A 

F87D : 4 A 

F87E : 4A 

F87F : 29 0F 

F88 1 : 60 

F882 : 

F 882 : A6 3A 
F884 : A4 3B 
F886 : 20 96 FD 
F889 : 20 48 F9 
F88C : A 1 3A 
F 88E : A8 
F88F : 4A 

F890 : 90 05 F897 

F892 :6A 

F893 : B0 0C F8A1 

F895 : 29 87 

F897 : 4A 

F898 : AA 

F899 : BD 62 F9 

F89C : 20 79 F8 

F89F : D0 04 F8A5 

F8A 1 : A0 FC 

F8A3 : A9 00 

F8A5 : AA 

F8A6 : BD A6 F9 

F8A9 : 85 2E 

F8AB : 29 03 

F8AD : 

F8AD : 85 2F 

F8AF : 20 35 FC 

F8B2 : F0 18 F8CC 

F8B4 : 29 8F 

F8B6 : AA 

F8B7 : 98 

F8B8 : A0 03 

F8BA : E0 8A 

F8BC : F 0 0B F8C9 

F8BE : 4A 

F8BF : 90 08 F8C9 

F8C1 :4A 

F8C2 : 4 A 

F8C3 : 09 20 

F8C5 : 88 

F8C6 : D0 FA F8C2 
F8C8 : C8 
F8C9 : 88 

F8CA : D0 F2 F8BE 

F8CC : 60 

F8CD: 

F8CD: FF FF FF 
F8D0 : 

F8D0 : 20 82 F8 
F8D3 : 48 
F8D4 :B1 3A 
F8D6 : 20 DA FD 
F8D9 : A2 01 
F8DB : 20 4A F9 
F8DE : C4 2F 
F8E0 : C8 

F8E 1 : 90 FI F8D4 

F8E3 : A2 03 

F8E5 : C0 04 

F8E7 : 90 F2 F8DB 


74 SCRN LSR A 

75 PHP 

76 JSR GBASCALC 

77 LDA CGBASL), Y 

78 PLP 

79 SCRN2 BCC RTMSKZ 

80 LSR A 

81 LSR A 

82 LSR A 

83 LSR A 

84 RTMSKZ AND '<0F 

85 RTS 

86 * 


READ SCREEN Y-C00RD/2 
SAVE LSB CCARRY) 

CALC BASE ADDRESS 
GET BYTE 

RESTORE LSB FROM CARRY 
IF EVEN, USE LO H 


{SHIFT HIGH HALF BYTE DOWN 
{MASK 4-BITS 


87 INSDS1 LDX PCL 

88 LDY PCH 

89 JSR PRYX2 

90 JSR PRBLNK 

91 LDA CPCL.X) 

92 INSDS2 TAY 

93 LSR A 

94 BCC I EVEN 

95 ROR A 

96 BCS ERR 

97 AND '<87 

98 I EVEN LSR A 

99 TAX 

100 LDA FMT 1 , X 

101 JSR SCRN2 

102 BNE GETFMT 

103 ERR LDY MFC 

104 LDA '<00 

105 GETFMT TAX 

106 LDA FMT2 , X 

107 STA FORMAT 

108 AND '<03 

109 ; C0-1 BYTE, 1-2 BYTE, 2-3 

110 STA LENGTH 

111 JSR NEWOPS 

112 BEQ GOTONE 

113 AND '<8F 

114 TAX 

115 TYA 

116 LDY '<03 

117 CPX ' S8A 

118 BEQ MNNDX3 

119 MNNDX1 LSR A 

120 BCC MNNDX3 

121 LSR A 

122 MNNDX2 LSR A 

123 ORA '<20 

124 DEY 

125 BNE MNNDX2 

126 I NY 

127 MNNDX3 DEY 

128 BNE MNNDX1 

129 GOTONE RTS 

130 * 

131 DFB <FF , <FF , <FF 

132 • 

133 INSTDSP JSR INSDS1 

134 PHA 

135 PRNTOP LDA CPCL),Y 

136 JSR PRBYTE 

137 LDX '<01 

138 PRNTBL JSR PRBL2 


{PRINT PCL.H 


{FOLLOWED BY A BLANK 
{GET OPCODE 
{Lable moved down 1 
{ EVEN/ODD TEST 

{BIT 1 TEST 
{ XXXXXX 1 1 INVALID OP 
{MASK BITS 

{LSB INTO CARRY FOR L/R TEST 

{GET FORMAT INDEX BYTE 
; R/L H-BYTE ON CARRY 

{SUBSTITUTE <FC FOR INVALID OPS 
{SET PRINT FORMAT INDEX TO 0 

{INDEX INTO PRINT FORMAT TABLE 
{SAVE FOR ADR FIELD FORMATTING 
{MASK FOR 2-BIT LENGTH 
BYTE) 

;get Index for new opcodes 
{found a new op Cor no op) 

{MASK FOR 1XXX1010 TEST 

{OPCODE TO A AGAIN 


{FORM INDEX INTO MNEMONIC TABLE 

{ 1) 1XXX1010 -> 0010 1 XXX 
{ 2) XXXYYY0 1 -> 00111 XXX 
{ 3) XXXYYY 1 0 -> 0 0 1 1 0 X X X 
{ 4) XXXYY100 -> 00100XXX 
{ 5) XXXXX000 -> 000XXXXX 


-,GEN FMT, LEN BYTES 
{SAVE MNEMONIC TABLE INDEX 


{PRINT 2 BLANKS 


139 CPY LENGTH {PRINT INST C1-3 BYTES) 

140 INY ;IN A 12 CHR FIELD 

141 BCC PRNTOP 


142 LDX '<03 ;CHAR COUNT FOR MNEMONIC INDEX 

143 CPY '<04 

144 BCC PRNTBL 
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F8E9 : 68 
F8EA : A8 
F8EB : B9 C0 F9 
F8EE : 85 2C 
F8F 0 : B9 00 FA 
F8F3 : 85 2D 
F8F5 : A9 00 
F8F7 : A0 05 
F8F9 : 06 2D 
F8FB : 26 2C 
F8FD : 2A 
F8FE : 88 

F8FF : D0 F8 F8F9 
F90 1 : 69 BF 
F903 : 20 ED FD 
F906 : CA 

F907 : D0 EC F8F5 
F909 : 20 48 F9 
F90C : A4 2F 
F90E : A2 06 
F91 0 : E0 03 
F9 1 2 : F0 1C F930 
F9 1 4 : 06 2E 
F9 16 : 90 0E F926 
F9 18 : BD B9 F9 
F9 1 B : 20 ED FD 
F91 E : BD B3 F9 
F92 1 : F0 03 F926 

F923 : 20 ED FD 
F926 : CA 

F927 : D0 E7 F910 
F929 : 60 
F92A : 

F92A : 88 

F92B : 30 E7 F914 

F92D : 20 DA FD 

F930 : A5 2E 

F932 : C9 E8 

F934 : B 1 3A 

F936 : 90 F2 F92A 

F938 : 20 56 F9 

F93B : AA 

F93C : E8 

F93D : D0 01 F940 

F93F : C8 

F940 : 98 

F94 1 : 20 DA FD 

F944 :8A 

F945 : 4C DA FD 

F948 : 

F948 : A2 03 
F94A : A9 A0 
F94C : 20 ED FD 
F94F : CA 

F950 : D0 F8 F94A 
F952 : 60 
F953 : 

F953 : 38 
F954 : A5 2F 
F956 : A4 3B 
F958 : AA 

F959 : 1 0 01 F95C 

F95B : 88 

F95C : 65 3A 

F95E : 90 01 F961 

F960 : C8 

F96 1:60 

F962 : 

F962 : 

F962 : 

F962 : 


145 PLA 

146 TAY 

147 LDA 

148 STA 

149 LDA 

150 STA 

151 PRMN1 LDA 

152 LDY 

153 PRMN2 ASL 

154 ROL 

155 ROL 

156 DEY 

157 BNE 

158 ADC 

159 JSR 

160 DEX 

161 BNE 

162 JSR 

163 LDY 

164 LDX 

165 PRADR1 CPX 

166 BEQ 

167 PRADR2 ASL 

168 BCC 

169 LDA 

170 JSR 

171 LDA 

172 BEQ 

173 JSR 

174 PRADR3 DEX 

175 BNE 

176 RTS 

177 • 

178 PRADR4 DEY 

179 BMI 

180 JSR 

181 PRADR5 LDA 

182 CMP 

183 LDA 

184 BCC 

185 RELADR JSR 

186 TAX 

187 I NX 

188 BNE 

189 I NY 

190 PRNTYX TYA 

191 PRNTAX JSR 

192 PRNTX TXA 

193 JMP 

194 • 

195 PRBLNK LDX 

196 PRBL2 LDA 

197 PRBL3 JSR 

198 DEX 

199 BNE 

200 RTS 

201 • 

202 PCADJ SEC 

203 PCADJ2 LDA 

204 PCADJ3 LDY 

205 TAX 

206 BPL 

207 DEY 

208 PCADJ4 ADC 

209 BCC 

210 INY 

211 RTS2 RTS 

212 • 


213 ; FMT 1 BYTES: 

214 ; IF Y-0 

215 ; IF Y-1 


; RECOVER MNEMONIC INDEX 


MNEML , Y 

LMNEM ; FETCH 3-CHAR MNEMONIC 

MNEMR.Y ; (PACKED INTO 2-BYTES) 

RMNEM 

'*00 

'*05 

RMNEM ; SH I FT 5 BITS OF CHARACTER INTO A 

LMNEM 

A ; (CLEARS CARRY) 

PRMN2 

'*BF ; ADD "? M OFFSET 

COUT ; OUTPUT A CHAR OF MNEM 


PRMN1 

PRBLNK 

LENGTH 

'*06 

'*03 

PRADR5 

FORMAT 

PRADR3 

CHARI-1 ,X 

COUT 

CHAR2-1 ,X 

PRADR3 

COUT 


OUTPUT 3 BLANKS 

CNT FOR 6 FORMAT BITS 

IF X-3 THEN ADDR. 


PRADR1 


PRADR2 

PRBYTE 

FORMAT 

'*E8 

(PCL) , Y 

PRADR4 

PCADJ3 


; HANDLE REL ADR MODE 
; SPEC I AL (PRINT TARGET, 

; NOT OFFSET) 

;PCL,PCH«-OFFSET*1 TO A , Y 


PRNTYX ;♦! TO Y,X 


PRBYTE 

PRBYTE 


; OUTPUT TARGET ADR 
; OF BRANCH AND RETURN 


'*03 ; BLANK COUNT 

'* A0 ; LOAD A SPACE 

COUT ; OUTPUT A BLANK 


PRBL2 


; LOOP UNTIL COUNT-0 


; 0 - 1 BYTE, 1-2 BYTE, 

LENGTH ; 2-3 BYTE 

; TEST DISPLACEMENT SIGN 
PCADJ4 ; (FOR REL BRANCH) 

; EXTEND NEG BY DECR PCH 

PCL 

RTS2 ; PCL + LENGTH( OR DISPL)*1 TO A 

; CARRY INTO Y (PCH) 


XXXXXXY0 INSTRS 
THEN RIGHT HALF BYTE 
THEN LEFT HALF BYTE 


F962 : 
F962 : 
F962 : 0F 
F963 : 22 
F964 : FF 
F965 : 33 
F966 : CB 
F967 : 62 
F968 : FF 
F969 : 73 
F96A : 03 
F96B : 22 
F96C : FF 
F96D : 33 
F96E : CB 
F96F : 66 
F970 : FF 
F97 1 : 77 
F972 : 0F 
F973 : 20 
F974 : FF 
F975 : 33 
F976 : CB 
F977 : 60 
F978 : FF 
F979 : 70 
F97A : 0F 
F97B : 22 
F97C : FF 
F97D: 39 
F97E : CB 
F97F :66 
F980 : FF 
F981 :7D 
F982: 0B 
F983 : 22 
F984 : FF 
F985 : 33 
F 986 : CB 
F987 : A6 
F988 : FF 
F989 : 73 
F98A: 11 
F98B : 22 
F98C : FF 
F98D : 33 
F98E : CB 
F98F : A6 
F990 : FF 
F99 1 : 87 
F992 : 0 1 
F993 : 22 
F994 : FF 
F995 : 33 
F996 : CB 
F997 : 60 
F998 : FF 
F999 : 70 
F99A : 0 1 
F99B : 22 
F99C : FF 
F99D : 33 
F99E : CB 
F99F : 60 
F9A0 : FF 
F9A 1 : 70 
F9A2 : 24 
F9A3 : 3 1 
F9A4 : 65 
F9A5 : 78 
F9A6 : 


216 ; 

217 * 

218 FMT 1 

219 

220 
221 
222 

223 

224 

225 

226 

227 

228 

229 

230 

231 

232 

233 

234 

235 

236 

237 

238 

239 

240 

241 

242 

243 

244 

245 

246 

247 

248 

249 

250 

251 

252 

253 

254 

255 

256 

257 

258 

259 

260 
261 
262 

263 

264 

265 

266 

267 

268 

269 

270 

271 

272 

273 

274 

275 

276 

277 

278 

279 

280 
281 
282 

283 

284 

285 

286 ; ZZXXXY0 1 


(X-INDEX) 


DFB *0F 
DFB *22 
DFB *FF 
DFB *33 
DFB *CB 
DFB *62 
DFB *FF 
DFB *73 
DFB *03 
DFB *22 
DFB *FF 
DFB *33 
DFB *CB 
DFB *66 
DFB *FF 
DFB *77 
DFB *0F 
DFB *20 
DFB *FF 
DFB *33 
DFB *CB 
DFB *60 
DFB *FF 
DFB *70 
DFB *0F 
DFB *22 
DFB *FF 
DFB *39 
DFB *CB 
DFB *66 
DFB *FF 
DFB *7D 
DFB *0B 
DFB *22 
DFB *FF 
DFB *33 
DFB *CB 
DFB * A6 

DFB *FF 
DFB *73 
DFB *11 
DFB *22 
DFB *FF 
DFB *33 
DFB *CB 
DFB * A6 

DFB *FF 
DFB *87 
DFB *01 
DFB *22 
DFB *FF 
DFB *33 
DFB *CB 
DFB *60 
DFB *FF 
DFB *70 
DFB *01 
DFB *22 
DFB *FF 
DFB *33 
DFB *CB 
DFB *60 
DFB *FF 
DFB *70 
DFB *24 
DFB *31 
DFB *65 
DFB *78 
INSTR'S 
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r : v to 
F9A7 : 2 1 
F9A8 : 8 1 
F9A9 : 82 
F9AA : 59 
F9AB : 4D 
F9AC :91 
F9AD : 92 
F9AE : 86 
F9AF : 4A 
F9B0 : 85 
F9B1 :9D 
F9B2 : 49 
F9B3 : 5A 
F9B4: 
F9B4 : D9 
F9B5 : 0 0 
F9B6 : D8 
F9B7:A4 
F9B8 : A4 
F9B9 : 00 
F9BA : 
F9BA s AC 
F9BB : A9 
F9BC : AC 
F9BD : A3 
F9BE :A8 
F9BF :A4 
F9C0 : 1C 
F9C 1 :8A 
F9C2 : 1C 
F9C3 : 23 
F9C4 :5D 
F9C5 : 8B 
F9CS : IB 
F9C7 : A 1 
F9C8 : 9D 
F9C9 : 8A 
F9CA : ID 
F9CB : 23 
F9CC : 9D 
F9CD : 8B 
F9CE : ID 
F9CF : A 1 
F9D0 : 1C 
F9D 1 : 29 
F9D2 : 19 
F9D3 : AE 
F9D4-.69 
F9D5 : A8 
F9D6: 19 
F9D7 : 23 
F9D8 : 24 
F9D9 : 53 
F9DA: IB 
F9DB : 23 
F9DC : 24 
F9DD : 53 
F9DE: 19 
F9DF : A 1 
F9E0 : AD 
F9E 1 : 1 A 
F9E2 : 5B 
F9E3 : 5B 
F9E4 : A5 
F9E5 : 89 
F9E6 : 24 
F9E7 : 24 
F9E8 : AE 
F9E9 : AE 
F9E A : A8 


288 

289 

290 

291 

292 

293 

294 

295 

296 

297 

298 

299 

300 

301 • 

302 CHAR2 

303 

304 

305 

306 

307 

309 CHARI 

310 

311 

312 

313 

314 

315 MNEML 

316 

317 

318 

319 

320 

321 

322 

323 

324 

325 

326 

327 

328 

329 

330 

331 

332 

333 

334 

335 

336 

337 

338 

339 

340 

341 

342 

343 

344 

345 

346 

347 

348 

349 

350 

351 

352 

353 

354 

355 

356 

357 


DFB $00 
DFB $21 
DFB $81 
DFB $82 
DFB $59 
DFB $4D 
DFB $91 
DFB $92 
DFB $86 
DFB $4A 
DFB $85 
DFB $9D 
DFB $49 
DFB $5A 

DFB $D9 
DFB $00 
DFB $D8 
DFB $ A4 
DFB $A4 
DFB $00 

DFB $AC 
DFB $ A9 
DFB $AC 
DFB $ A3 
DFB $ A8 
DFB $ A4 
DFB $1C 
DFB $8A 
DFB $1C 
DFB $23 
DFB $SD 
DFB $8B 
DFB $ 1 B 
DFB $ A 1 
DFB $9D 
DFB $8A 
DFB $ 1 D 
DFB $23 
DFB $9D 
DFB $8B 
DFB $ 1 D 
DFB $A 1 
DFB $1C 
DFB $29 
DFB $19 
DFB $AE 
DFB $69 
DFB $ A8 
DFB $19 
DFB $23 
DFB $24 
DFB $53 
DFB $ 1 B 
DFB $23 
DFB $24 
DFB $53 
DFB $19 
DFB $A 1 
DFB $AD 
DFB $ 1 A 
DFB $5B 
DFB $5B 
DFB $ A5 
DFB $69 
DFB $24 
DFB $24 
DFB $AE 
DFB $AE 
DFB $ A8 


; ERR 
; IMM 
; Z-PAGE 
; ABS 

; (ZPAG , X ) 

; (ZPAG) , Y 
; ZPAG , X 
; ABS , X 
; ABS , Y 
; (ABS) 

; ZPAG , Y 
; RELATIVE 
; (ZPAG) (new) 

; ( ABS , X ) (new) 

; 'Y' 

; (byte F of FMT2) 
; ' Y # 


; BRA 


5 (A) FORMAT ABOVE 
; TSB 


(B) FORMAT 
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F9EB: AD 
F9EC : 29 
F9ED : 8A 
F9EE : 7C 
F9EF : 8B 
F9F0: 15 
F9F1 :9C 
F9F2 : 6D 
F9F3 : 9C 
F9F 4 : A5 
F9F5 : 69 
F9F6 : 29 
F9F7 : 53 
F9F8 : 84 
F9F9: 13 
F9FA : 34 
F9FB : 1 1 
F9FC : A5 
F9FD : 69 
F9FE : 23 
F9FF : A0 
FA00: 
FA00 : D8 
FA0 1 : 62 
FA02 : 5A 
FA03 : 48 
FA04 : 26 
FA05 : 62 
FA06 : 94 
FA07 :88 
F A08 : 54 
FA09 : 44 
FA0 A : C8 
FA0B : 54 
F A0C : 68 
FA0D : 44 
FA0E : E8 
FA0F : 94 
FA 1 0 : C4 
FA 1 1 : B4 
FA 1 2 : 08 
FA 1 3 : 84 
FA 1 4 : 74 
FA 1 5 : B4 
FA 16 : 28 
FA 1 7 : 6E 
FA 1 8 : 74 
FA 1 9 : F4 
FA 1 A : CC 
F A 1 B : 4A 
FA 1 C : 72 
FA1D:F2 
FA1E: A4 
FA IF :8A 
FA20 : 06 
FA21 : AA 
FA22 : A2 
FA23 : A2 
FA24 : 74 
FA2S : 74 
F A26 : 74 
FA27 : 72 
FA28 : 44 
FA29 : 68 
FA2A :B2 
F A2B : 32 
F A2C : B2 
FA2D : 72 
FA2E : 22 
FA2F : 72 
FA30: 1 A 


358 

359 

360 

361 

362 

363 

364 

365 

366 

367 

368 

369 

370 

371 

372 

373 

374 

375 

376 

377 

378 

379 • 

380 MNEMR 

381 

382 

383 

384 

385 

386 

387 

388 

389 

390 

391 

392 

393 

394 

395 

396 

397 

398 

399 

400 

401 

402 

403 

404 

405 

406 

407 

408 

409 

410 

411 

412 

413 

414 

415 

416 

417 

418 

419 

420 

421 

422 

423 

424 

425 

426 

427 

428 


DFB $AD 
DFB $29 
DFB $8A 
DFB $7C 
DFB $8B 
DFB $15 
DFB $9C 
DFB $6D 
DFB $9C 
DFB $A5 
DFB $69 
DFB $29 
DFB $53 
DFB $84 
DFB $13 
DFB $34 
DFB $11 
DFB $ AS 
DFB $69 
DFB $23 
DFB $A0 

DFB $D8 
DFB $62 
DFB $SA 
DFB $48 
DFB $26 
DFB $62 
DFB *94 
DFB $88 
DFB $54 
DFB $44 
DFB $C8 
DFB *54 
DFB *68 
DFB *44 
DFB «E8 
DFB *94 
DFB *C4 
DFB *B4 
DFB *08 
DFB *84 
DFB *74 
DFB *B4 
DFB *28 
DFB *6E 
DFB *74 
DFB *F4 
DFB *CC 
DFB «4A 
DFB *72 
DFB *F2 
DFB *A4 
DFB *8A 
DFB *06 
DFB *AA 
DFB * A2 
DFB *A2 
DFB *74 
DFB *74 
DFB *74 
DFB *72 
DFB $44 
DFB *68 
DFB *B2 
DFB *32 
DFB *B2 
DFB *72 
DFB *22 
DFB *72 
DFB * 1 A 


; (C) FORMAT 


; (D) FORMAT 


; (E) FORMAT 


; BRA 


; (A) FORMAT 
; TSB 


; (B) FORMAT 


; (C) FORMAT 
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19 AUTOST 1 


Appl 

e //c F8 

moni tor 

f 1 rmwar e 
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F A3 1 : 1 A 



429 


DFB 

tIA 


F AA3 : 6C 

F2 

03 

500 

NOFIX 

JMP 

(SOFTEV) 


FA32 : 26 



430 


DFB 

$26 


FAA6 : 



501 

• 




F A33 : 26 



431 


DFB 

$26 


F AA6 : 20 

CA 

FC 

502 

PWRUP 

JSR 

COLDSTART 

Trash memory, init ports 

FA34:72 



432 


DFB 

$72 


FAA9: 


FAA9 

503 

SETPG3 

EQU 

* 

{ SET PAGE 3 VECTORS 

F A35 : 72 



433 


DFB 

$72 


F AA9 : A2 

05 


504 


LDX 

#5 


F A36 : 88 



434 


DFB 

$88 


F AAB : BD 

FC 

FA 

505 

SETPLP 

LDA 

PWRCON- 1 , X 

; WITH CNTRL B ADRS 

F A37 : C8 



435 


DFB 

$C8 

; (D) FORMAT 

FAAE : 9D 

EF 

03 

506 


STA 

BRKV-1 ,X 

{ OF CURRENT BASIC 

FA38:C4 



436 


DFB 

$C4 


FAB1 : CA 



507 


DEX 



F A39 : CA 



437 


DFB 

$CA 


FAB2 : D0 

F7 

FAAB 

508 


BNE 

SETPLP 


F A3A : 26 



438 


DFB 

$26 


FAB4 : A9 

C6 


509 


LDA 

MC6 

{ LOAD HI SLOT ♦ 1 

F A3B : 48 



439 


DFB 

$48 


FAB6 : 80 

5A 

FB 1 2 

510 


BRA 

PWRUP2 

branch around mnemonics 

F A3C : 44 



440 


DFB 

$44 


FAB8: 



511 

• 




FA3D: 44 



441 


DFB 

$44 


FAB8: 



512 

• Extension to MNEML (left mnemonics) 

F A3E : A2 



442 


DFB 

$A2 


FAB8 : 



513 

• 




F A3F : C8 



443 


DFB 

$C8 

; (E) FORMAT 

F AB8 : 8A 



514 


DFB 

$8A 

PHY 

FA40: 



444 

• 




F AB9 : 8B 



515 


DFB 

$8B 

PLY 

F A4 0 : 85 

45 


445 

IRQ 

STA 

$45 

{♦ Trash $45 for those who want it 

FABA: A5 



516 


DFB 

$A5 

STZ 

FA42 : A5 

45 


446 


LDA 

$45 

• ♦ 

F ABB : AC 



517 


DFB 

$ AC 

TRB 

FA44 : 4C 

03 

C8 

447 


JMP 

NEWIRQ 

; ♦ 

F ABC : 00 



518 


DFB 

$00 

??? 

FA47: 



448 

• 




FABD: 



519 

• 




FA47: 



449 

* 




FABD: 



520 

* This extension 

to the monitor reset routine ($FA62) 

FA47 : 



450 

* NEWBRK 

is called by the 

interrupt handler which has 

FABD: 



521 

* checks 

for ape 

le keys. If both are pressed, it aoes 

FA47 : 



451 

• set the 

hardware to its 

default state and encoded 

FABD: 



522 

* into an 

exerciser mode. If the open apple key only is 

FA47 s 



452 

• the state In 

the accumulator. Software that wants 

FABD: 



523 

* pressed 

, memory is selectively trashed and a cold start 

FA47 : 



4S3 

• to do break 

processing 

using full system resources 

FABD: 



524 

• 1 5 done 




FA47 s 



454 

• can restore 

the machine 

state from this value. 

FABD: 



525 

• 




FA47 : 



455 

• 




F ABD : A9 

FF 


526 

RESET. X 

LDA 

MFF 


FA47 : 85 

44 


456 

NEWBRK 

STA 

MACSTAT 

;save state of machine 

F ABF : 8D 

FB 

04 

527 


STA 

VMODE 

Initialize mode 

F A49 : 7A 



457 


PLY 


{restore registers for save 

F AC2 : 20 

3A 

FF 

528 


JSR 

BELL 

♦ Need bell delay for 3.5“ 

F A4A : FA 



458 


PLX 



F AC5 : 20 

F8 

C5 

529 


JSR 

PCNVRST 

♦ Reset protocol converter 

F A4B : 68 



459 


PLA 



F AC8 : 0E 

62 

C0 

530 


ASL 

BUTN1 


FA4C: 



460 

• 




FACB : 2C 

61 

C0 

531 


BIT 

BUTN0 


F A4C : 28 



461 

BREAK 

PLP 


{Note: same as old BREAK routine!! 

FACE: 10 

5E 

FB2E 

532 


BPL 

RTS2D 


F A4D : 20 

4 A 

FF 

462 


JSR 

SAVE 

{save reg'5 on BRK 

F AD0 : 90 

D4 

FAA6 

533 


BCC 

PWRUP 

open apple only, reboot 

F A50 : 68 



463 


PLA 


; including PC 

F AD2 : 4C 

Cl 

C7 

534 


JMP 

BANGER 

both apples, exercise 'er 

FA51 :8S 

3A 


464 


STA 

PCL 


F ADS : EA 



535 


NOP 


{♦ align code 

F AS3 : 68 



465 


PLA 



FAD6 : EA 



536 


NOP 



F A54 : 85 

3B 


466 


STA 

PCH 


F AD7 : 20 

8E 

FD 

537 

REGDSP 

JSR 

CROUT 

{DISPLAY USER REG CONTENTS 

F A56 : 6C 

F 0 

03 

467 


JMP 

CBRKV) 

{call BRK HANDLER 

F ADA : A9 

44 


538 

RGDSP1 

LDA 

M44 

{WITH LABELS 

FAS9: 



468 

• 




F ADC : 85 

40 


539 


STA 

A3L 

{Memory state now printed 

F A59 : 20 

82 

F8 

469 

□LDBRK 

JSR 

INSDS1 

{PRINT USER PC 

F ADE : A9 

00 


540 


LDA 

#$00 


F A5C : 20 

DA 

FA 

470 


JSR 

RGDSP1 

; AND REGS 

F AE 0 : 85 

41 


541 


STA 

A3H 


F ASF : 4C 

65 

FF 

471 


JMP 

MON 

;G0 TO MONITOR (NO PASS GO, NO 

F AE2 : A2 

FA 


542 


LDX 

#$FA 


$200 ! ) 








FAE4 : A9 

A0 


543 

RDSP1 

LDA 

#$A0 


FA62: 



472 

• 




FAE6 : 20 

ED 

FD 

544 


JSR 

COUT 


F A62 : D8 



473 

RESET 

OLD 


;D0 THIS FIRST THIS TIME 

F AE9 : BD 

9A 

CE 

545 


LDA 

RTBL-$FA , X 


F A63 : 20 

84 

FE 

474 


JSR 

SETNORM 


FAEC : 20 

ED 

FD 

546 


JSR 

COUT 


F A66 : 20 

2F 

FB 

475 


JSR 

INIT 


FAEF : A9 

BD 


547 


LDA 

#$BD 


F A69 : 20 

4D 

CE 

476 


JSR 

ZZQU I T , 

{♦ Setvld $ Setkbd 

FAF 1 : 20 

ED 

FD 

548 


JSR 

COUT 


F A6C : 20 

1 A 

C4 

477 


JSR 

I N I TMOUSE 

{initialize the mouse 

F AF4 : B5 

4A 


549 


LDA 

ACC*5 , X 


F A6F : 20 

04 

CC 

478 


JSR 

CLRPORT 

{clear port setup bytes 

FAF6 : 80 

0A 

FB02 

550 


BRA 

RGDSP2 

make room for mnemonics 

FA72 : 9C 

FF 

04 

479 


STZ 

ACIABUF 

;and the commahead buffer 

FAF8 : 



551 

• 




FA75 : AD 

SF 

C0 

480 


LDA 

SETAN3 

; AN3 - TTL HI 

FAF8 : 



552 

* Riqht half of 

new mnemonics, 

indexed from MNEMR 

FA78 : 20 

BD 

FA 

481 


JSR 

RESET. X 

; initialize other devices 

FAF8 : 



553 

• 




FA7B : 2C 

10 

C0 

482 


BIT 

KBDSTRB 

{ CLEAR KEYBOARD 

FAF8 : 74 



554 


DFB 

$74 

PHY 

FA7E : 80 

05 

FA85 

483 


BRA 

BEEPSKIP 

;♦ Bell already beeped 

FAF9 : 74 



555 


DFB 

$74 

PLY 

F A80 : EA 



484 


NOP 


{♦ align code 

FAFA : 76 



556 


DFB 

$76 

STZ 

FA81 :D8 



485 

NEWMON 

OLD 



FAFB: C6 



557 


DFB 

$C6 

TRB 

FA82 : 20 

3A 

FF 

486 


JSR 

BELL 

{ CAUSES DELAY IF KEY BOUNCES 

FAFC : 00 



558 


DFB 

$00 

??? 

FA85 : AD 

F3 

03 

487 

BEEPSKIP 

LDA 

SOFTEV* 1 

; IS RESET HI 

FAFD : 



559 

• 




F A88 : 49 

AS 


488 


EOR 

MAS 

; A FUNNY COMPLEMENT OF THE 

FAFD:59 

FA 


560 

PWRCON 

DW 

OLDBRK 


FA8A : CD 

F 4 

03 

489 


CMP 

PWREDUP 

{ PWR UP BYTE ??? 

FAFF : 00 

E0 

45 

561 


DFB 

$00 , $E0 , $45 


FA8D: D0 

17 

FAA6 

490 


BNE 

PWRUP 

{ NO SO PWRUP 

FB02 : 



562 

• 




FA8F : AD 

F2 

03 

491 


LDA 

SOFTEV 

{ YES SEE IF COLD START 

FB02 : 20 

DA 

FD 

563 

RGDSP2 

JSR 

PRBYTE 


FA92 : D0 

0F 

FAA3 

492 


BNE 

NOFIX 

{ HAS BEEN DONE YET? 

FB05 : E8 



564 


I NX 



F A94 : A9 

E0 


493 


LDA 

ME0 

; DOES SEV POINT AT BASIC? 

FB06 : 30 

DC 

FAE4 

565 


BMI 

RDSP1 


F A96 : CD 

F3 

03 

494 


CMP 

SOFTEV* 1 


FB08 : 60 



566 


RTS 



FA99 : D0 

08 

FAA3 

495 


BNE 

NOFIX 

{ YES SO REENTER SYSTEM 

FB09 : 



567 

• 




FA9B: A0 

03 


496 

FIXSEV 

LDY 

#3 

{ NO SO POINT AT WARM START 

FB09 : C 1 

F 0 

F0 EC 

568 

TITLE 

ASC 

'Apple 

II* 

FA9D : 8C 

F2 

03 

497 


STY 

SOFTEV 

5 FOR NEXT RESET 

FBI 1 :C4 



569 


DFB 

$C4 

{optional filler 

FAA0 : 4C 

00 

E 0 

498 


JMP 

BASIC 

{ AND DO THE COLD START 

FB12: 



570 

• 




FAA3 : 



499 

• 














^ 19 AUT0ST1 

oo 

FB 1 2 : 86 00 
FB 1 4 : 85 01 
FB 16 : 20 60 FB 
FB 19 : 6C 00 00 
FBI C : 0 0 
FB 1 D : 0 0 
FB1E : 

FB1E : 4C 00 C9 

FB2 1 : A0 00 

FB23 : EA 

FB24 : EA 

FB25 : BD 64 C0 

FB28 : 1 0 04 FB2E 

FB2A : C8 

FB2B: D0 F8 FB25 
FB2D : 88 
FB2E : 60 
FB2F: 


Apple //c F8 monitor firmware 

571 PWRUP2 STX LOC0 

572 STA LOCI 

573 JSR APPLE I I 

574 JMP CLOC0) 

575 BRK 

576 BRK 

577 • 

578 PREAD JMP MPADDLE 

579 LDY #$00 

580 NOP 

581 NOP 

582 PREAD2 LDA PADDL0 , X 

583 BPL RTS2D 

584 INY 

585 BNE PREAD2 

586 DEY 

587 RTS2D RTS 

49 INCLUDE AUT0ST2 
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; SETPG3 MUST RETURN X-0 
; SET PTR H 
;Dlsplay our banner... 

; JUMP $C600 


read mouse paddle 
; I N I T COUNT 

; COMPENSATE FOR 1ST COUNT 
; COUNT Y-REG EVERY 12 USEC. 


; EX I T AT 255 MAX 


20 AUT0ST2 


Apple //c F8 


tor firmware 
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FB2F : 

FB2F : A9 00 

FB3 1 : 85 48 

FB33 : AD 56 C0 

FB36: AD 54 C0 

FB39: AD 51 C0 

FB3C : A9 00 

FB3E : F 0 0B FB4B 

FB40 : AD 50 C0 

FB43 : AD 53 C0 

FB46 : 20 36 F8 

FB49 : A9 14 

FB4B : 85 22 

FB4D: EA 

FB4E : EA 

FB4F : 20 0A CE 

FB52 : 80 05 FB59 

FB54 : 

FB54 : 09 80 
FB56 : 4C 54 CD 
FB59 : 

FB59 : A9 17 
FB5B : 85 25 
FB5D : 4C 22 FC 
FB60 : 

FB60 : 20 58 FC 
FB63 : A0 09 
FB65 : B9 BA C5 
FB68 : 99 0D 04 
FB6B : 88 

FB6C : D0 F7 FB65 
FB6E : 60 
FB6F : 

FB6F : AD F3 03 
FB72 : 49 A5 
FB74 : 8D F4 03 
FB77 : 60 
FB78: 

FB78 : FB78 

FB78 : C9 8D 
FB7A : D0 18 FB94 

FB7C : AC 00 C0 
FB7F : 1 0 13 FB94 

FB8 1 : C 0 93 
FB83 : D0 0F FB94 
FB85 : 2C 10 C0 
FB88 : AC 00 C0 
FB8B : 1 0 FB FB88 
FB8D : C0 83 
FB8F : F0 03 FB94 
FB9 1 : 2C 10 C0 
FB94 : 2C 7B 06 
FB97 : 30 64 FBFD 
FB99 : 89 60 
FB9B: F0 B7 FB54 
FB9D : 20 B8 C3 
FBA0 : EE 7B 05 
FBA3 : AD 7B 05 
FBA6 : 2C IF C0 
FBA9 : 30 05 FBB0 
FBAB : 8D 7B 04 
FBAE : 85 24 
FBB0 : 80 46 FBF8 
FBB2 : 

FBB2 : EA 
FBB3 : 

FBB3 : 06 
FBB4 : 

FBB4 : 1 0 06 FBBC 
FBB6 : C9 A0 
FBB8 : 90 02 


2 • 

3 INIT LDA 

4 STA 

5 LDA 

6 LDA 

7 SETTXT LDA 

8 LDA 

9 BEQ 

10 SETGR LDA 

1 1 LDA 

12 JSR 

13 LDA 

14 SETWND STA 

15 NOP 

16 NOP 

17 JSR 

18 BRA 

19 • 

20 DOCTL ORA 

21 JMP 

22 • 

23 VTAB23 LDA 

24 TABV STA 

25 JMP 

26 * 

27 APPLE I I JSR 

28 LDY 

29 STITLE LDA 

30 STA 

31 DEY 

32 BNE 

33 RTS 

34 • 

35 SETPWRC LDA 

36 EOR 

37 STA 

38 RTS 

39 • 

40 V I DWA I T EQU 

41 CMP 

42 BNE 

43 LDY 

44 BPL 

45 CP Y 

46 BNE 

47 BIT 

48 KBDWAIT LDY 

49 BPL 

50 CP Y 

51 BEQ 

52 BIT 

53 NOWAIT BIT 

54 BMI 

55 BIT 

56 BEQ 

57 JSR 

58 NEWADV INC 

59 LDA 

60 BIT 

61 BMI 

62 STA 

63 STA 

64 NEWADV1 BRA 

65 • 

66 NOP 

67 • 


68 F8VERSI ON DFB 

69 • 

70 DOCOUT1 BPL 

71 CMP 

72 BCC 


#$00 

STATUS 

LORES 

TXTPAGE 1 

TXTSET 

#$00 

SETWND 

TXTCLR 

MIXSET 

CLRTOP 

#$14 

WNDTOP 


WNDREST 

VTAB23 

#$80 

CTLCHAR0 

#$17 

CV 

VTAB 

HOME 

#9 

APPLE2C- 1 , Y 
L I NE 1 ♦ 13 , Y 

STITLE 


SOFTEV* 1 

#$AS 

PWREDUP 


#$8D 

NOWAIT 

KBD 

NOWAIT 

#$93 

NOWAIT 

KBDSTRB 

KBD 

KBDWAIT 
#$83 
NOWAIT 
KBDSTRB 
VFACTV 
VIDOUT 
#$60 
DOCTL 
STORCH 
OURCH 
OURCH 
RD80VID 
NEWADV 1 
OLDCH 
CH 

ADV2 


G00DF8 


# $ A 0 

DCX 


5 CLR STATUS FOR DEBUG SOFTWARE 


; INIT VIDEO MODE 
; SET FOR TEXT MODE 
-.FULL SCREEN WINDOW 

i SET FOR GRAPHICS MODE 
-.LOWER 4 LINES AS TEXT WINDOW 


; SET WINDOW 


;40/80 column width 


icontrols need high bit 
;execute control char 

; VTAB TO ROW 23 
; VTABS TO ROW IN A-REG 
; don ' t set OURCV! ! 

; CLEAR THE SCRN 

; GET A CHAR 

5 PUT IT AT TOP CENTER OF SCREEN 


; ROUT I NE TO CALCULATE THE 'FUNNY 
; COMPLEMENT' FOR THE RESET VECTOR 


; CHECK FOR A PAUSE CCONTROL-S). 
; ONLY WHEN I HAVE A CR 
; NOT SO, DO REGULAR 
; IS KEY PRESSED? 

; NO . 

; YES - IS IT CTRL-S? 

; NOPE - IGNORE 
; CLEAR STROBE 

; WA I T TILL NEXT KEY TO RESUME 
-.WAIT FOR KEYPRESS 
; I S IT CONTROL-C? 

-.YES, SO LEAVE IT 
; CLR STROBE 

;is video firmware active? 
i*>no, do normal 40 column 
1 1 9 it a control? 

;»>yea, do it 

Sprint w/lnverse mask 

•.advance cursor 

; and update others 

;but only if not 80 columns 

j“>80 columns, leav'em 


•.check for CR 


;//e, chela ID byte 

;»>video firmware active, no mask 
;ls it control char? 

5 ">yes, no mask 


FBBC 



20 AUT0ST2 


Apple //c F8 

moni tor 

f 1 rmware 
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20 AUT0ST2 


Appl 

e //c F8 

monitor 

f i rmware 

26- JUL-85 PAGE 66 

FBBA : 25 

32 


73 

AND 

INVFLG 

{else apply inverse mask 

FC35 : 



144 

• 




FBBC : 4C 

F6 

FD 

74 DCX 

JMP 

COUTZ 

;and print character 

FC35: 



145 

• NEWOPS 

translates the opcode in the Y register 

FBBF : 00 



75 

BRK 



FC35: 



146 

* to a mnemonic 

table index 

and returns with Z-1. 

FBC0 : 



76 • 




FC35: 



147 

• If Y is 

not a 

new opcode, 

Z-0. 

FBC0 : 00 



77 

DFB 

$00 

;chels ID byte 

FC35 : 



148 

• 




FBC 1 : 



78 * 




FC35 : 98 



149 

NEWOPS 

TYA 


;get the opcode 

FBC 1 : 48 



79 BASCALC 

PHA 


; CALC BASE ADDR IN BASL , H 

FC36 : A2 

16 


150 


LDX 

*NUMOPS 

;check through new opcodes 

FBC2:4A 



80 

LSR 

A 

; FOR GIVEN LINE NO. 

FC38 : DD 

FE 

FE 

151 

NEW0P1 

CMP 

OPTBL.X 

;does it match? 

FBC3 : 29 

03 


81 

AND 

*$03 

; 0<«LINE NO. <-$17 

FC3B : F 0 

43 

FC80 

152 


BEQ 

GETINDX 

;->yes, get new index 

FBC5 : 09 

04 


82 

□ RA 

*$04 

; ARG-000ABCDE , GENERATE 

FC3D: CA 



153 


DEX 



FBC7 : 85 

29 


83 

STA 

BASH 

; BASH-00000 1CD 

FC3E : 10 

F8 

FC38 

154 


BPL 

NEW0P1 

;else check next one 

FBC9 : 68 



84 

PLA 


; AND 

FC40 : 60 



155 


RTS 


;not found, exit with BNE 

FBCA : 29 

18 


85 

AND 

*$18 

; BASL-EABAB000 

FC4 1 ; 



156 

• 




FBCC : 90 

02 

FBD0 

86 

BCC 

BASCLC2 


FC4 1 ; 00 



157 


BRK 



FBCE : 69 

7F 


87 

ADC 

*$7F 


FC42 : 



158 

• 




FBD0 : 85 

28 


88 BASCLC2 

STA 

BASL 


FC42 : 80 

19 

FC5D 

159 

CLREOP 

BRA 

CLREOP 1 

; ESC F IS CLR TO END OF PAGE 

FBD2 : 0A 



89 

ASL 

A 


FC44 : A5 

25 


160 

CLREOP2 

LDA 

CV 


FBD3 : 0A 



90 

ASL 

A 


FC46 : 48 



161 

CLEOP1 

PHA 


; SAVE CURRENT LINE NO. ON STACK 

FBD4 : 05 

28 


91 

□ RA 

BASL 


FC47 : 20 

24 

FC 

162 


JSR 

VTABZ 

; CALC BASE ADDRESS 

FBD6 : 85 

28 


92 

STA 

BASL 


FC4A : 20 

9E 

FC 

163 


JSR 

CLEOLZ 

; CLEAR TO EOL. (SETS CARRY) 

FBD8 : 60 



93 

RTS 



FC4D: A0 

00 


164 


LDY 

*$00 

; CLEAR FROM H INDEX-0 FOR REST 

FBD9 : 



94 * 




FC4F : 68 



165 


PLA 


; INCREMENT CURRENT LINE NO. 

FBD9 : C9 

87 


95 CHKBELL 

CMP 

*$87 

; BELL CHAR? CCONTROL-G) 

FC50 : 1 A 



166 


INC 

A 


FBDB : D0 

12 

FBEF 

96 

BNE 

RTS2B 

; NO, RETURN. 

FC51 :C5 

23 


167 


CMP 

WNDBTM 

; DONE TO BOTTOM OF WINDOW? 

FBDD : A9 

40 


97 BELLI 

LDA 

*$40 

; YES... 

FC53 :90 

FI 

FC46 

168 


BCC 

CLE0P1 

; NO, KEEP CLEARING LINES. 

FBDF : 20 

A8 

FC 

98 

JSR 

WAIT 

; DELAY .01 SECONDS 

FC55 : B0 

CB 

FC22 

169 


BCS 

VTAB 

; YES, TAB TO CURRENT LINE 

FBE2 : A0 

C0 


99 

LDY 

*$C0 


FC57 : 00 



170 


BRK 



FBE4 : A9 

0C 


100 BELL2 

LDA 

*$0C 

; TOGGLE SPEAKER AT 1 KHZ 

FC58: 



171 

• 




FBE6 : 20 

A8 

FC 

101 

JSR 

WAIT 

; FOR .1 SEC. 

FC58 : 20 

A5 

CD 

172 

HOME 

JSR 

HOMECUR 

;move cursor home 

FBE9 : AD 

30 

C0 

102 

LDA 

SPKR 


FC5B: 80 

E7 

FC44 

173 


BRA 

CLRE0P2 

; then clear to end of page 

FBEC : 88 



103 

DEY 



FC5D: 



174 

• 




FBED : D0 

F5 

FBE4 

104 

BNE 

BELL2 


FC5D: 20 

9D 

CC 

175 

CLREOP 1 

JSR 

GETCUR 

;load Y with proper CH 

FBEF : 60 



105 RTS2B 

RTS 



FC60 : 80 

E2 

FC44 

176 


BRA 

CLRE0P2 

{before clearing page 

FBF 0 : 



106 • 




FC62 : 



177 

* 




FBF0 :A4 

24 


107 STORADV 

LDY 

CH 

;get 40 column position 

FC62 : 80 

0F 

FC73 

178 

CR 

BRA 

NEWCR 

;only LF if not Pascal 

FBF2 : 9 1 

28 


108 

STA 

(BASL) , Y 

;and store 

FC64 : 00 



179 


BRK 



FBF 4 : E6 

24 


109 ADVANCE 

INC 

CH 

; Increment cursor 

FC65 : 00 



180 


BRK 



FBFG : A5 

24 


110 

LDA 

CH 


FC66 : 



181 

• 




FBF8 : C5 

21 


111 ADV2 

CMP 

WNDWDTH 

; BEYOND WINDOW WIDTH? 

FC66 : E6 

25 


182 

LF 

INC 

CV 

; I NCR CURSOR V. (DOWN 1 LINE) 

FBFA : B0 

66 

FC62 

112 

BCS 

CR 

; YES, CR TO NEXT LINE. 

FC68 ; A5 

25 


183 


LDA 

CV 


FBFC : G0 



113 RTS3 

RTS 


; NO, RETURN. 

FC6A : C5 

23 


184 


CMP 

WNDBTM 

; OFF SCREEN? 

FBFD: 



114 • 




FC6C : 90 

1 A 

FC88 

185 


BCC 

NEWVTABZ 

; set base + WNDLFT 

FBFD : C9 

A0 


115 VIDOUT 

CMP 

*$A0 

; CONTROL CHAR? 

FC6E : C6 

25 


186 


DEC 

CV 

; DECR CURSOR V. (BACK TO BOTTOM) 

FBFF : B0 

EF 

FBF0 

1 16 

BCS 

STORADV 

; NO, OUTPUT IT. 

FC70 : 



187 

• 




FC01 :A8 



117 

TAY 


•.INVERSE VIDEO? 

FC70 : 4C 

35 

CB 

188 

SCROLL 

JMP 

SCROLLUP 

;scroll the screen 

FC02 : 10 

EC 

FBF0 

1 18 

BPL 

STORADV 

; YES, OUTPUT IT. 

FC73 ; 



189 

• 




FC04 : C9 

8D 


119 VIDOUT1 

CMP 

*$8D 

;CR? 

FC73 : 20 

E9 

FE 

190 

NEWCR 

JSR 

CLRCH 

; se t CH's to 0 

FC06 : F0 

6B 

FC73 

120 

BEQ 

NEWCR 

;Yes, use new routine 

FC76 : 2C 

FB 

04 

191 


BIT 

VMODE 

; i s it Pascal? 

FC08 : C9 

8A 


121 

CMP 

*$8A 

;LINE FEED? 

FC79: 10 

0A 

FC85 

192 


BPL 

CRRTS 

; pasca 1 , no LF 

FC0A :F0 

5A 

FC66 

122 

BEQ 

LF 

; IF SO, DO IT. 

FC7B: 20 

44 

FD 

193 


JSR 

NOESCAPE 

;else clear escape mode 

FC0C : C9 

88 


123 

CMP 

*$88 

; BACK SPACE? (CONTROL-H) 

FC7E : 80 

E6 

FC66 

194 


BRA 

LF 

; then do LF 

FC0E : D0 

C9 

FBD9 

124 

BNE 

CHKBELL 

; NO, CHECK FOR BELL. 

FC80 : 



195 

• 




FC 1 0 : 20 

E2 

FE 

125 B5 

JSR 

DECCH 

; decrement all cursor H indices 

FC80 : BD 

15 

FF 

196 

GETINDX 

LDA 

INDX.X 

{lookup index for mnemonic 

FC13: 10 

E7 

FBFC 

126 

BPL 

RTS3 

; I F POSITIVE, OK; ELSE MOVE UP. 

F C83 : A0 

00 


197 


LDY 

*0 

{exit with BEQ 

FC15-.A5 

21 


127 

LDA 

WNDWDTH 

;get window width, 

FC85 :60 



198 

CRRTS 

RTS 



FC 1 7 : 20 

EB 

FE 

128 

JSR 

WDTHCH 

;and set CH's to WNDWDTH- 1 

FC86 : 



199 

* 




FC 1 A : A5 

22 


129 UP 

LDA 

WNDTOP 

; CURSOR V INDEX 

FC86 : A5 

25 


200 

NEWVTAB 

LDA 

CV 

{update //e CV 

FC 1C : C5 

25 


130 

CMP 

CV 


FC88 : 8D 

FB 

05 

201 

NEWVTABZ 

STA 

OURCV 


FC 1 E : B0 

DC 

FBFC 

131 

BCS 

RTS3 

; top line, exit 

FC8B : 80 

97 

FC24 

202 


BRA 

VTABZ 

;and calc base+WNDLFT 

FC20 : C6 

25 


132 

DEC 

CV 

;not top, go up one 

FC8D: 



203 

• 




FC22 : 



133 « 




FC8D : 20 

9D 

CC 

204 

NEWCLREOL 

JSR 

GETCUR 

;get current cursor 

FC22 : 80 

62 

FC86 

134 VTAB 

BRA 

NEWVTAB 

; go update OURCV 

FC90 : A9 

A0 


205 

NEWCLEOLZ 

LDA 

*$A0 

;get a blank 

FC24 : 20 

Cl 

FB 

135 VTABZ 

JSR 

BASCALC 

;calculate the base address 

FC92 : 2C 

7B 

06 

206 


BIT 

VFACTV 

;if video firmware active, 

FC27 : A5 

20 


136 

LDA 

WNDLFT 

;get the left window edge 

FC95 : 30 

02 

FC99 

207 


BMI 

NEWC1 

;->don't use inverse mask 

FC29 : 2C 

IF 

C0 

137 

BIT 

RD80VID 

;80 columns? 

FC97 : 25 

32 


208 


AND 

INVFLG 


FC2C: 10 

02 

FC30 

138 

BPL 

VTAB40 

;->no, left edge ok 

FC99 : 4C 

C2 

CB 

209 

NEWC1 

JMP 

DOCLR 

; go do clear 

FC2E : 4A 



139 

LSR 

A 

•.divide width by 2 

FC9C : 



210 

• 




FC2F: 18 



140 

CLC 


;prepare to add 

FC9C : 80 

EF 

FC8D 

211 

CLREOL 

BRA 

NEWCLREOL 

;get cursor and clear 

FC30 :65 

28 


141 VTAB40 

ADC 

BASL 

;add width to base 

FC9E : 80 

F 0 

FC90 

212 

CLEOLZ 

BRA 

NEWCLEOLZ 

{clear from Y 

FC32 : 85 

28 


142 

STA 

BASL 


FCA0 : 



213 

• 




FC34 :60 



143 RTS4 

RTS 



FCA0 : A0 

00 


214 

CLRLIN 

LDY 

*0 

{clear entire line 
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FD1 1 : EA 286 NOP 
FD12: EA 287 NOP 
FD13: EA 288 NOP 
FD1 4 : EA 289 NOP 
FD15 : EA 290 NOP 
FD16:EA 291 NOP 
FD1 7 : EA 292 NOP 
FD18 : 293 • 

FD18 : 6C 38 00 294 KEY I N0 JMP 
FD1B: 295 * 

FD1B:91 28 296 KEYIN STA 
FD 1 D : 20 4C CC 297 JSR 
FD20 : 20 70 CC 298 DONXTCUR JSR 
FD23 : 1 0 FB FD20 299 BPL 
FD25 : 48 300 GOTKEY PHA 
FD26 : A9 08 301 LDA 
FD28 : 2C FB 04 302 BIT 
FD2B: D0 ID FD4A 303 BNE 
FD2D : 68 304 PLA 
FD2E : C9 9B 305 CMP 
FD30 : D0 06 FD38 306 BNE 
FD32 : 4C CC CC 307 JMP 
FD35 : 308 * 

FD35 : 4C ED CC 309 RDCHAR JMP 
FD38 : 310 • 

FD38 : 2C 7B 06 311 LOOKPICK BIT 
FD3B : 30 07 FD44 312 BMI 
FD3D : C9 95 313 CMP 
FD3F : D0 03 FD44 314 BNE 
FD4 1 : 20 ID CC 315 JSR 
FD44 : 316 • 


FD44 : 317 • NOESCAPE is 

FD44 : 318 • 

FD44 : 48 319 NOESCAPE PHA 


FD45 : A9 08 320 NOESC1 LDA 
FD47 : 0C FB 04 321 TSB 
FD4 A : 68 322 N0ESC2 PLA 
FD4B : 60 323 RTS 
FD4C : 324 • 

FD4C : EA 325 NOP 
FD4D: 326 * 

FD4D : 20 A6 C3 327 NOTCR JSR 
FD50 : C9 88 328 CMP 
FD52 : F 0 ID FD71 329 BEQ 
FD54 : C9 98 330 CMP 
FD56 : F 0 0A FD62 331 BEQ 
FD58 : E 0 F8 332 CPX 
FD5A : 90 03 FD5F 333 BCC 
FDSC : 20 3A FF 334 JSR 
FD5F : E8 335 NOTCR 1 INX 
FD60 : D0 13 FD75 336 BNE 
FD62 : A9 DC 337 CANCEL LDA 
FD64 : 20 A6 C3 338 JSR 
FD67 : 20 8E FD 339 GETLNZ JSR 
FD6A : A5 33 340 GETLN LDA 
FD6C : 20 ED FD 341 JSR 
FD6F : A2 01 342 GETLN1 LDX 
FD7 1 : 8A 343 BCKSPC TXA 
FD72 : F 0 F3 FD67 344 BEQ 
FD7 4 : CA 345 DEX 
FD75 : 20 ED CC 346 NXTCHAR JSR 
FD78 : C9 95 347 CMP 
FD7A : D0 08 FD84 348 BNE 
FD7C : 20 ID CC 349 JSR 
FD7F : EA 350 NOP 
FD80 : EA 351 NOP 
FD8 1 : EA 352 NOP 
FD82 : EA 353 NOP 
FD83 : EA 354 NOP 
FD84 : 9D 00 02 355 ADD I NP STA 
FD87 : C9 8D 356 CMP 


(KSML) 

C BASL ) , Y 
SHOWCUR 
UPDATE 
DONXTCUR 

'M.CTL 

VMODE 

N0ESC2 

'ESC 

LOOKPICK 

NEWESC 

ESCRDKEY 

VFACTV 

NOESCAPE 

'PICK 

NOESCAPE 

PICKY 

used by GETCOUT 


'M.CTL 

VMODE 


GETCOUT 
'*88 
BCKSPC 
'*98 
CANCEL 
'*F8 
NOTCR 1 
BELL 

NXTCHAR 
' *DC 
GETCOUT 
CROUT 
PROMPT 
COUT 
'*01 

GETLNZ 

ESCRDKEY 

'PICK 

ADDINP 

PICKY 


;hooks, no cursor may be displayed 


; GO TO USER KEY-IN 

ierase false Images 

{display true cursor 

{look for key, blink II cursor 

{loop until keypress 

{save character 

{were escapes enabled? 

{">no, there is no escape 
;yes, there may be a way out!! 
{escape? 

{“>no escape 

{">go do escape sequence 

; do RDKEY with escapes 

{only process f. arrow 

{if video firmware is active 

;was it PICK? < -> , CTL-U) 

{no, just return 

{yes, pick the character 

too . 


{save it 

{disable escape sequences 
;and enable controls 
{by setting M.CTL 


{disable controls and print 
{CHECK FOR EDIT KEYS 
; - BACKSPACE 

{ - CONTROL-X 

{MARGIN? 

{ YES, SOUND BELL 
{ADVANCE INPUT INDEX 

{BACKSLASH AFTER CANCELLED LINE 

{OUTPUT 'CR' 

{OUTPUT PROMPT CHAR 

{ I N I T INPUT INDEX 

{WILL BACKSPACE TO 0 

{do new RDCHAR (allow escapes) 
{USE SCREEN CHAR 
{ FOR CONTROL-U 
{lift char from screen 


; no upshifting needed 


I N , X 

'*8D 


{ADD TO INPUT BUFFER 
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FD89 : D0 

C2 

FD4D 

357 


BNE 

NOTCR 


FE04 : CA 



428 

BLANK 

DEX 


; BLANK TO MON 

FD8B : 20 

9C 

FC 

358 

CR0UT1 

JSR 

CLREOL 

; CLR TO EOL IF CR 

FE 05 : D0 

16 

FE ID 

429 


BNE 

SETMDZ 

; AFTER BLANK 

FD8E : A9 

8D 


359 

CROUT 

LDA 

#$8D 


FE 07 : C9 

BA 


430 


CMP 

#$BA 

-.DATA STORE MODE? 

FD90 : D0 

SB 

FDED 

360 


BNE 

COUT 

; (ALWAYS) 

FE09 : D0 

BB 

FDC6 

431 


BNE 

XAMPM 

; NO; XAM, ADD, OR SUBTRACT. 

FD92: 



361 

• 




FE0B: 



432 

* 




FD92 : A4 

3D 


362 

PRA 1 

LDY 

A 1 H 

; PR I NT CR , A 1 IN HEX 

FE0B : 85 

31 


433 

STOR 

STA 

MODE 

; KEEP IN STORE MODE 

FD94 : A6 

3C 


363 


LDX 

AIL 


FE0D: A5 

3E 


434 


LDA 

A2L 


FD96 : 20 

8E 

FD 

364 

PRYX2 

JSR 

CROUT 


FE0F : 9 1 

40 


435 


STA 

(A3L) , Y 

; STORE AS LOW BYTE AT (A3) 

FD99 : 20 

40 

F9 

365 


JSR 

PRNTYX 


FE 1 1 : E6 

40 


436 


INC 

A3L 


FD9C : A0 

00 


366 


LDY 

#$00 


FE 13:D0 

02 

FE 1 7 

437 


BNE 

RTSS 

; I NCR A3, RETURN. 

FD9E : A9 

AD 


367 


LDA 

MAD 

; PR I NT 

FE 15 : E6 

41 


438 


INC 

A3H 


FDA0 : 4C 

ED 

FD 

368 


JMP 

COUT 


FE 1 7 : 60 



439 

RTS5 

RTS 



FDA3 : 



369 

« 




FE 18: 



440 

• 




FDA3 : A5 

3C 


370 

X AM8 

LDA 

AIL 


FE 18 : A4 

34 


441 

SETMODE 

LDY 

YSAV 

; SAVE CONVERTED '♦', 

FDA5 : 09 

07 


371 


ORA 

#$07 

; SET TO FINISH AT 

FE 1 A : B9 

FF 

01 

442 


LDA 

IN-1 ,Y 

; , ' . ' AS MODE 

FDA7 : 85 

3E 


372 


STA 

A2L 

; MOD 8-7 

FE 1 D : 85 

31 


443 

SETMDZ 

STA 

MODE 


FDA9: AS 

3D 


373 


LDA 

A 1 H 


FE 1 F : 60 



444 


RTS 



FDAB : 85 

3F 


374 


STA 

A2H 


FE20: 



445 

* 




FDAD : AS 

3C 


375 

M0D8CHK 

LDA 

AIL 


FE20 : A2 

01 


446 

LT 

LDX 

#$01 


FDAF : 29 

07 


376 


AND 

#$07 


FE22 : B5 

3E 


447 

LT2 

LDA 

A2L , X 

; COPY A2 (2 BYTES) TO 

FDB 1 :D0 

03 

FDB6 

377 


BNE 

DATAOUT 


FE24 : 95 

42 


448 


STA 

A4 L , X 

; A4 AND A5 

FDB3 : 20 

92 

FD 

378 

XAM 

JSR 

PRA 1 


FE26 : 95 

44 


449 


STA 

A5L , X 


FDBG : A9 

A0 


379 

DATAOUT 

LDA 

# $ A0 


FE28 : CA 



450 


DEX 



FDB8 : 20 

ED 

FD 

380 


JSR 

COUT 

; OUTPUT BLANK 

FE 29 : 10 

F7 

FE22 

451 


BPL 

LT2 


FDBBrBI 

3C 


381 


LDA 

( A 1 L ) , Y 


FE2B : 60 



452 


RTS 



FDBD: 20 

DA 

FD 

382 


JSR 

PRBYTE 

; OUTPUT BYTE IN HEX 

FE2C: 



453 

• 




FDC0 : 20 

BA 

FC 

383 


JSR 

NXTA1 


FE2C :B1 

3C 


454 

MOVE 

LDA 

(AIL) ,Y 

; MOVE (A1) THRU (A2) TO (A4) 

FDC3 : 90 

E8 

FDAD 

384 


BCC 

M0D8CHK 

; NOT DONE YET. GO CHECK MOD 8 

FE2E:91 

42 


455 


STA 

(A4L) , Y 


FDCS : 60 



385 

RTS4C 

RTS 


; DONE . 

FE30 : 20 

B4 

FC 

456 


JSR 

NXTA4 


FDC6: 



386 

• 




FE33 : 90 

F7 

FE2C 

457 


BCC 

MOVE 


FDC6 : 4A 



387 

XAMPM 

LSR 

A 

; DETERMINE IF MONITOR MODE IS 

FE35 : 60 



458 


RTS 



FDC7 : 90 

EA 

FDB3 

388 


BCC 

XAM 

; EXAMINE, ADD OR SUBTRACT 

FE36 : 



459 

* 




FDC9 : 4A 



389 


LSR 

A 


FE36 : B1 

3C 


460 

VERIFY 

LDA 

(AIL) ,Y 

•.VERIFY (A1) THRU (A2) 

FDCA : 4A 



390 


LSR 

A 


FE38 : D 1 

42 


461 


CMP 

( A4L) , Y 

; WITH ( A4 ) 

FDCB : A5 

3E 


391 


LDA 

A2L 


FE3A : F 0 

1C 

FE58 

462 


BEQ 

VFYOK 


FDCD : 90 

02 

FDD1 

392 


BCC 

ADD 


FE3C : 20 

92 

FD 

463 


JSR 

PRA 1 


FDCF : 49 

FF 


393 


EOR 

#$FF 

-.FORM 2 ' S COMPLEMENT FOR SUBTRACT. 

FE3F : B1 

3C 


464 


LDA 

(AIL) ,Y 


FDD1 : 65 

3C 


394 

ADD 

ADC 

AIL 


FE4 1 : 20 

DA 

FD 

465 


JSR 

PRBYTE 


FDD3 : 48 



395 


PHA 



FE44 : A9 

A0 


466 


LDA 

#$A0 


FDD4:A9 

BD 


396 


LDA 

#$BD 

; PR I NT THEN RESULT 

FE46 : 20 

ED 

FD 

467 


JSR 

COUT 


FDD6 : 20 

ED 

FD 

397 


JSR 

COUT 


FE 49 : A9 

A8 


468 


LDA 

#$A8 


FDD9 : 68 



398 


PLA 



FE4B : 20 

ED 

FD 

469 


JSR 

COUT 


FDDA : 



399 

• 




FE4E : B1 

42 


470 


LDA 

( A4L) , Y 


FDDA : 48 



400 

PRBYTE 

PHA 


; PR I NT BYTE AS 2 HEX DIGITS 

FE50 : 20 

DA 

FD 

471 


JSR 

PRBYTE 


FDDB:4A 



401 


LSR 

A 

; (DESTROYS A-REG) 

FE53 : A9 

A9 


472 


LDA 

#$A9 


FDDC : 4A 



402 


LSR 

A 


FE55 : 20 

ED 

FD 

473 


JSR 

COUT 


FDDD : 4A 



403 


LSR 

A 


FE58 : 20 

B4 

FC 

474 

VFYOK 

JSR 

NXTA4 


FDDE : 4A 



404 


LSR 

A 


FE5B : 90 

D9 

FE36 

475 


BCC 

VERIFY 


FDDF : 20 

E5 

FD 

405 


JSR 

PRHEXZ 


FEED : 60 



476 


RTS 



FDE2 : 68 



406 


PLA 



FE5E : 



477 

• 




FDE3 : 



407 

• 




FE5E : 20 

75 

FE 

478 

LIST 

JSR 

A 1 PC 

; MOVE A 1 (2 BYTES) TO 

FDE3 : 29 

0F 


408 

PRHEX 

AND 

#$0F 

; PR I NT HEX DIGIT IN A-REG 

FE6 1 : A9 

14 


479 


LDA 

#$14 

; PC IF SPEC'D AND 

FDES : 09 

B0 


409 

PRHEXZ 

ORA 

#$B0 

jLSBITS ONLY. 

FE63 : 48 



480 

LIST2 

PHA 


{♦DISASSEMBLE 20 INSTRUCTIONS 

FDE7 : C9 

BA 


410 


CMP 

#$BA 


FE64 : 20 

C4 

CS 

481 


JSR 

SHOWINST 

; *Di splay a line 

FDE9 : 90 

02 

FDED 

411 


BCC 

COUT 


FE67 : 68 



482 


PLA 



FDEB :69 

06 


412 


ADC 

#$06 


FE68 : 3A 



483 


DEC 

A 

{♦Count down 

FDED: 



413 

• 




FE69 : D0 

F8 

FE63 

484 


BNE 

LIST2 


FDED:6C 

36 

00 

414 

COUT 

JMP 

(CSWL) 

; VECTOR TO USER OUTPUT ROUTINE 

FE6B:60 



485 


RTS 



FDF 0 : 



415 

• 




FE6C: 



486 

• 




FDF 0 : 2C 

7B 

06 

416 

COUT 1 

BIT 

VFACTV 

; video firmware active? 

FE6C : 4C 

86 

C9 

487 

MINI 

JMP 

GETINST1 

;+Go to the mini assembler 

FDF3 : 4C 

B4 

FB 

417 


JMP 

DOCOUT1 

; mask II mode characters 

FE6F : C6 

34 


488 

TRACE 

DEC 

YSAV 

;*Stay on T for trace 

FDF6 : 84 

35 


418 

COUTZ 

STY 

YSAV1 

; SAVE Y-REG 

FE71 :4C 

43 

CA 

489 

STEPZ 

JMP 

STEP 

{♦Off to the step routine 

FDF8 : 48 



419 


PHA 


; SAVE A -REG 

FE74 : 


0001 

490 


da 

$FE75- * , 0 

{♦Extra bytes 

FDF9 : 20 

78 

FB 

420 


JSR 

V1DWAIT 

; OUTPUT CHR AND CHECK FOR CTRL-S 

FE75 : 



491 

• 




FDFC : 68 



421 


PLA 


; RESTORE A-REG 

FE75 : 8A 



492 

A 1PC 

TXA 


;IF USER SPECIFIED AN ADDRESS, 

FDFD : A4 

35 


422 


LDY 

YSAV1 

; AND Y-REG 

FE76 : F0 

07 

FE7F 

493 


BEQ 

A1PCRTS 

{ COPY IT FROM A 1 TO PC. 

FDFF : 60 



423 


RTS 


■.RETURN TO SENDER... 

FE78: B5 

3C 


494 

A1PCLP 

LDA 

A 1 L , X 

{YEP, SO COPY IT. 

FE00 : 



424 

* 




FE7A : 95 

3A 


495 


STA 

PCL.X 


FE00 : C6 

34 


425 

BL1 

DEC 

YSAV 


FE7C : CA 



496 


DEX 



FE02 : F0 

9F 

FDA3 

4 26 


BEQ 

XAM8 


FE7D: 10 

F9 

FE78 

497 


BPL 

A1PCLP 


FE04 : 



427 

• 




FE7F : 60 



498 

A1PCRTS 

RTS 





Apple //c F8 


26- JUL-85 


PAGE 71 


20 AUT0ST2 


FE80 : 

FE80 : A0 3F 

FE82 : D0 02 FE86 

FE84 : A0 FF 

FE86 : 84 32 

FE88 : 60 

FE89 : 

FE89 : A9 00 
FE8B : 85 3E 
FE8D: A2 38 
FE8F : A0 IB 
FE9 1 : D0 08 FE9B 
FE93 : 

FE93 : A9 00 

FE95 : 85 3E 

FE97 : A2 36 

FE99 : A0 F0 

FE9B: A5 3E 

FE9D : 29 0F 

FE9F : D0 06 FEA7 

FEA 1 : C0 IB 

FEA3 : F0 39 FEDE 

FE A5 : 80 IB FEC2 

FE A7 : 09 C0 

FEA9.-A0 00 

FEAB : 94 00 

FEAD : 95 01 

FEAF : 60 

FEB0 : 

FEB0 : 4C 00 E0 
FEB3 : 

FEB3 : 4C 03 E0 
FEB6 : 

FEB6 : 20 75 FE 
FEB9 : 20 3F FF 
FEBC : 6C 3A 00 
FEBF : 

FEBF:4C D7 FA 
FEC2 : 

FEC2 : 3A 

FEC3 : 8D FB 07 

FEC6 : A9 F7 

FEC8 : 80 04 FECE 

FECA: 

FECA : 4C F8 03 
FECD: 

FECD: 60 
FECE: 

FECE : 8D 7B 06 

FED1 :8D 0E C0 

FED4 : 0C FB 04 

FED7 : DA 

FED8 : 5A 

FED9 : 20 CD CD 

FEDC : 7A 

FEDD: FA 

FEDE : A9 FD 

FEE0 : 80 C9 FEAB 

FEE2 : 

FEE2 : 

FEE2 : 

FEE2 : 

FEE2 : 

FEE2: 

FEE2 : 5A 
FEE3 : 20 9D CC 
FEE6 : 88 

FEE7 : 80 05 FEEE 
FEE9: 

FEE9 : A9 01 
FEEB: 3A 


monitor firmware 

499 • 

500 SET I NV LDY '<3F 

501 BNE SETIFLG 

502 SETNORM LDY '<FF 

503 SETIFLG STY INVFLG 

504 RTS 

505 • 

506 SETKBD LDA '<00 

507 INPORT STA A2L 

508 INPRT LDX 'KSWL 

509 LDY 'KEYIN 

510 BNE IOPRT 

511 • 

512 SETVID LDA '<0 

513 GUTPORT STA A2L 

514 OUTPRT LDX 'CSWL 

515 LDY 'COUT1 

516 IOPRT LDA A2L 

517 AND '$0F 

518 BNE NOTPRT0 

519 CP Y 'KEYIN 

520 BEQ IOPRT1 

521 BRA OPRT0 

522 NOTPRT0 ORA '<IOADR 

523 LDY '<00 

524 I0PRT2 STY LOC0.X 

525 STA LOC1.X 

526 RTS 

527 • 

528 XBASIC JMP BASIC 

529 • 

530 BASCONT JMP BASIC2 

531 • 

532 GO JSR A 1PC 

533 JSR RESTORE 

534 JMP CPCL) 

535 • 

536 REGZ JMP REGDSP 

537 * 

538 OPRT0 DEC A 

539 STA CURSOR 

540 LDA '$FF-M . CTL 

541 BRA DOPR0 

542 • 

543 USR JMP USRADR 

544 • 

545 WRITE RTS 

546 • 

547 DOPR0 STA VFACTV 

548 STA CLRALTCHAR 

549 TSB VMODE 

550 PHX 

551 PHY 

552 JSR CHK80 

553 PLY 

554 PLX 

555 IOPRT1 LDA '<COUT1 

556 BRA I0PRT2 

557 * 

558 • DECCH decrements the curri 

559 • CLRCH sets all cursors to 

560 • SETCUR sets cursors to va 

561 • See explanatory note with 

562 * 

563 DECCH PHY 

564 JSR GETCUR 

565 DEY 

566 BRA SETCUR 1 

567 • 

568 CLRCH LDA '1 

569 WDTHCH DEC A 


SET FOR INVERSE VID 
VIA C0UT1 

SET FOR NORMAL VID 


; DO ' I N'0 ' 

; DO ' I N'AREG' 


; DO ' PR'0 ' 

; DO 'PR'AREG' 


;not slot 0 
;Continue if KEYIN 

;->do PR'0 


;TO BASIC, COLD START 

; TO BASIC, WARM START 

; ADDR TO PC IF SPECIFIED 
; RESTORE FAKE REGISTERS 
; AND GO! 

; GO DISPLAY REGISTERS 
; Need <FF 

;set checkerboard cursor 
; reset mode 


; JUMP TO CONTROL-Y VECTOR IN RAM 

;Tape write not needed 

! say video firmware inactive 
;swltch in normal char set 
;don't change M.CTL 
; save X and Y 
; f or rest of PR'0 
; convert to 40 if needed 


;set I/O page 

;«>go set output hook 



ue in Acc. 
GETCUR 


; C f r om <FC10> 

;get current CH 
;decrement it 
; go update cursors 

;set all cursors to 0 

;dec window width (from $FC17) 
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FF2D:A9 

C5 


64 1 

PRERR 

LDA 

#$C5 

•.PRINT 'ERR', THEN FALL INTO 

FFAD : 20 

B4 

C5 

712 

NXTCHR JSR 

GETUP ;Get char, iny, upshift 

FF2F : 20 

ED 

FD 

642 


JSR 

COUT 

; FWEEPER . 

FFB0 : 49 

B0 


713 


EOR 

#$B0 


FF32 : A9 

D2 


643 


LDA 

#$D2 


FFB2 : C9 

0 A 


714 


CMP 

#$0A 


FF34:20 

ED 

FD 

644 


JSR 

COUT 


FFB4 : 90 

D4 

FF8A 

715 


BCC 

DIG ;it's a dlqit 

FF37 : 20 

ED 

FD 

645 


JSR 

COUT 


FFB6 : 69 

88 


716 


ADC 

#$88 


FF3A : 



646 

• 




FFB8 : C9 

FA 


717 


CMP 

#$FA 


FF3A : A9 

87 


647 

BELL 

LDA 

#$87 

; MAKE A JOYFUL NOISE, THEN RETURN. 

FFBA : 4C 

C5 

CF 

718 


JMP 

LOOK ASC 

Check for quote 

FF3C:4C 

ED 

FD 

648 


JMP 

COUT 


FFBD : 00 



719 


BRK 



FF3F : 



649 

• 




FFBE : 



720 

• 




FF3F : AS 

48 


650 

RESTORE 

LDA 

STATUS 

; RESTORE 6502 REGISTER CONTENTS 

FFBE : A9 

FE 


721 

TOSUB 

LDA 

#<GO 

DISPATCH TO SUBROUTINE, BY 

FF4 1 : 48 



651 


PHA 


; USED BY DEBUG SOFTWARE 

FFC0 : 48 



722 


PHA 


PUSHING THE HI -ORDER SUBR ADDR , 

FF42 : A5 

45 


652 


LDA 

A5H 


FFC 1 :B9 

E3 

FF 

723 


LDA 

SUBTBL, Y 

THEN THE LO-ORDER SUBR ADDR 

FF44 : A6 

46 


653 

RESTR1 

LDX 

XREG 


FFC4 : 48 



724 


PHA 


ONTO THE STACK, 

FF 46 : A4 

47 


654 


LDY 

YREG 


FFC5 : A5 

31 


725 


LDA 

MODE 

(CLEARING THE MODE, SAVE THE OLD 

FF 48 : 28 



655 


PLP 



FFC7 : A0 

00 


726 

ZMODE 

LDY 

#$00 

MODE IN A-REG), 

FF 49 : 60 



656 


RTS 



FFC9 : 84 

31 


727 


STY 

MODE 


FF4A : 



657 

• 




FFCB : 60 



728 


RTS 


AND 'RTS' TO THE SUBROUTINE! 

FF4 A : 85 

45 


658 

SAVE 

STA 

A5H 

; SAVE 6502 REGISTER CONTENTS 

FFCC: 



729 

• 




FF4C : 86 

46 


659 

SAV1 

STX 

XREG 

; FOR DEBUG SOFTWARE 

FFCC :BC 



730 

CHRTBL DFB 

$BC 

*C (BASIC WARM START) 

FF4E : 84 

47 


660 


STY 

YREG 


FF CD : B2 



731 


DFB 

$B2 

* Y (USER VECTOR) 

FF50 : 08 



661 


PHP 



FF CE : BE 



732 


DFB 

$BE 

*E (OPEN AND DISPLAY REGISTERS) 

FF5 1 : 68 



662 


PLA 



FFCF : 9A 



733 


DFB 

$9A 

♦! (Mini assembler) 

FF52 : 85 

48 


663 


STA 

STATUS 


FFD0 : EF 



734 


DFB 

$EF 

V (MEMORY VERIFY) 

FF54 : BA 



664 


TSX 



FFD1 :C4 



735 


DFB 

$C4 

*K ( I N#SL0T) 

FF55 : 86 

49 


665 


STX 

SPNT 


FFD2 : A9 



736 


DFB 

$ A9 

A P (PR#SLOT) 

FF57 : D8 



666 


CLD 



FFD3 : BB 



737 


DFB 

$BB 

*B (BASIC COLD START) 

FF58 : 60 



667 


RTS 



FFD4 :A6 



738 


DFB 

$A6 

'-' (SUBTRACTION) 

FF59: 



668 

• 




FFD5 : A4 



739 


DFB 

$A4 

'♦' (ADDITION) 

FF59 : 20 

84 

FE 

669 

OLDRST 

JSR 

SETNORM 

; SET SCREEN MODE 

FFD6 : 06 



740 


DFB 

$06 

M (MEMORY MOVE) 

FF5C : 20 

2F 

FB 

670 


JSR 

INIT 

; AND INIT KBD/SCREEN 

FFD7 : 95 



741 


DFB 

$95 

'<' (DELIMITER FOR MOVE, VFY ) 

FF5F : 20 

93 

FE 

671 


JSR 

SETVID 

; AS I/O DEVS. 

FFD8 : 07 



742 


DFB 

$07 

N (SET NORMAL VIDEO) 

FF62 : 20 

89 

FE 

672 


JSR 

SETKBD 


FFD9 : 02 



743 


DFB 

$02 

I (SET INVERSE VIDEO) 

FF6S : 



673 

• 




FFDA : 05 



744 


DFB 

$05 

L (DISASSEMBLE 20 INSTRS) 

FF6S : D8 



674 

MON 

CLD 


; MUST SET HEX MODE! 

FFDB : 00 



745 


DFB 

$00 

G (EXECUTE PROGRAM) 

FF66 : 20 

3A 

FF 

675 


JSR 

BELL 

; FWEEPER . 

FFDC : 93 



746 


DFB 

$93 

(MEMORY FILL) 

FF69 : A9 

AA 


676 

MONZ 

LDA 

#$AA 

PROMPT FOR MONITOR 

FFDD : A7 



747 


DFB 

$ A7 

'.' (ADDRESS DELIMITER) 

FF6B:85 

33 


677 


STA 

PROMPT 


FFDE : C6 



748 


DFB 

$C6 

'CR' (END OF INPUT) 

FF6D : 20 

67 

FD 

678 


JSR 

GETLNZ 

; READ A LINE OF INPUT 

FFDF :99 



749 


DFB 

$99 

BLANK 

FF70 : 20 

C7 

FF 

679 


JSR 

ZMODE 

; CLEAR MONITOR MODE, SCAN IDX 

FFE0 : EC 



750 


DFB 

$EC 

♦ S (Step) 

FF73 : 20 

A7 

FF 

680 

NXTITM 

JSR 

GETNUM 

; GET ITEM, NON-HEX 

FFE 1 : ED 



751 


DFB 

$ED 

♦T (Trace) 

FF76 : 84 

34 


681 


STY 

YSAV 

; CHAR IN A-REG. 

FFE2 : EA 



752 


NOP 


* 

FF78 : A0 

17 


682 


LDY 

#SUBTBL-CHRTBL 

; X-REG-0 IF NO HEX INPUT 

FFE3 : 



753 

• 




FF7A : 88 



683 

CHRSRCH 

DEY 



FFE3 : 



754 

• Table of low 

order monitor routine 

FF7B : 30 

E8 

FF65 

684 


BMI 

MON 

•.COMMAND NOT FOUND, BEEP $ TRY 

FFE3 : 



755 

• dispatch addresses. 









AGAIN. 

FFE3: 



756 

• 




FF7D:D9 

CC 

FF 

685 


CMP 

CHRTBL , Y 

-.FIND COMMAND CHAR IN TABLE 

FFE3 : B2 



757 

SUBTBL DFB 

>BASCONT- 1 


FF80 :D0 

F8 

FF7A 

686 


BNE 

CHRSRCH 

; NOT THIS TIME 

FFE4 : C9 



758 


DFB 

>USR- 1 


FF82 : 20 

BE 

FF 

687 


JSR 

TOSUB 

; GOT IT! CALL CORRESPONDING 

FFE5 : BE 



759 


DFB 

>REGZ- 1 









SUBROUTINE 

FFE6:6B 



760 


DFB 

> M I N I — 1 

+ 

FF85 : A4 

34 


688 


LDY 

YSAV 

; PROCESS NEXT ENTRY ON HIS LINE 

FFE7 : 35 



761 


DFB 

> VER I FY - 1 


FF87 : 4C 

73 

FF 

689 


JMP 

NXTITM 


FFE8 : 8C 



762 


DFB 

> I NPRT- 1 


FF8A : 



690 

• 




FFE9 : 96 



763 


DFB 

>OUTPRT- 1 


FF8A : A2 

03 


691 

DIG 

LDX 

#$03 


FFEA : AF 



764 


DFB 

> XBAS I C- 1 


FF8C : 0A 



692 


ASL 

A 


FFEB: 17 



765 


DFB 

>SETMODE- 1 


FF8D: 0A 



693 


ASL 

A 

; GOT HEX DIGIT, 

FFEC : 17 



766 


DFB 

>SETMODE- 1 


FF8E : 0A 



694 


ASL 

A 

; SHIFT INTO A2 

FFED : 2B 



767 


DFB 

>MOVE - 1 


FF8F : 0A 



695 


ASL 

A 


FFEE: IF 



768 


DFB 

>LT- 1 


FF90 : 0A 



696 

NXTBIT 

ASL 

A 


FFEF :83 



769 


DFB 

>SETNORM- 1 


FF9 1 : 26 

3E 


697 


ROL 

A2L 


FFF 0 : 7F 



770 


DFB 

>SET I NV- 1 


FF93.-26 

3F 


698 


ROL 

A2H 


FFF 1 : 5D 



771 


DFB 

>L I ST- 1 


FF95 : CA 



699 


DEX 


;LEAVE X-$FF IF DIG 

FFF2 : B5 



772 


DFB 

>GO- 1 


FF96: 10 

F8 

FF90 

700 


BPL 

NXTBIT 


FFF3: 17 



773 


DFB 

>SETMODE- 1 


FF98 : A5 

31 


701 

NXTBAS 

LDA 

MODE 


FFF4: 17 



774 


DFB 

>SETMODE- 1 


FF9A : D0 

06 

FFA2 

702 


BNE 

NXTBS2 

; IF MODE IS ZERO, 

FFF5 : F5 



775 


DFB 

>CRMON- 1 


FF9C : B5 

3F 


703 


LDA 

A2H , X 

; THEN COPY A2 TO A1 AND A3 

FFF6 : 03 



776 


DFB 

>BLANK- 1 


FF9E : 95 

3D 


704 


STA 

A1H.X 


FFF7 : 70 



777 


DFB 

>STEPZ- 1 

♦ 

FFA0 : 95 

41 


705 


STA 

A3H.X 


FFF8 :6E 



778 


DFB 

>TRACE- 1 

; ♦ 

FFA2 : E8 



706 

NXTBS2 

I NX 



FFF9 : 



779 

• 




FFA3:F0 

F3 

FF98 

707 


BEQ 

NXTBAS 


FFF9 : 


000 1 

780 


ds 

$FFFA- # , 0 


FFA5 : D0 

06 

FFAD 

708 


BNE 

NXTCHR 


FFFA : 



781 

• 




FFA7 : A2 

00 


709 

GETNUM 

LDX 

#$00 

; CLEAR A2 

FFFAiFB 

03 


782 


DW 

NMI 

NON-MASKABLE INTERRUPT VECTOR 

FFA9 : 86 

3E 


710 


STX 

A2L 










FFAB : 86 

3F 


711 


STX 

A2H 
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FFFC:62 FA 783 DW RESET ; RESET VECTOR 

FFFE : 03 C8 784 IRQVECT DW NEWIRQ {INTERRUPT REQUEST VECTOR 

0000 : 50 Include bank2 
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C17A:BD 7C 05 73 Ida mouxh.x 

C17D:DD 7D 07 74 cmp maxxh.x 

C180:F0 08 C18A 75 beq cmnolnt 

C182:FE 7C 04 76 cmrok inc mouxl.x -.Move right 

C185:D0 03 C18A 77 bne cmnoint 

C187:FE 7C 05 78 inc mouxh.x 

C 1 8A : E 0 00 79 cmnolnt cpx *0 

C18C.-F0 BO C14B 80 beq cmloop 

C18E:8D 48 C0 81 cmnoy sta mouclr 

C191:A9 02 82 Ida *movmode ; Should we enable VBL? 

C 1 93 : 2D FC 07 83 and moumode 

C196:F0 09 C1A1 84 beq cmnovbl ; Branch if not 

C198:8D 79 C0 85 sta iouenbl 

C 19B : 8D 5B C0 86 sta iou*3 -.Enable VBL int 

C19E:8D 78 C0 87 sta ioudsbl 

C1A1:09 20 88 cmnovbl ora 'movarm ;Mark that we moved 

C 1 A3 : 0C 7C 06 89 tsb mouarm 

C 1 A6 : A9 0E 90 Ida '$0E 

C 1 A8 : 2D 7C 07 91 and moustat 

C 1 AB : 69 FE 92 adc '*FE ;C-1 iff any bits were 1 

C1AD:B0 05 C1B4 93 xmdone bcs acialnt ; I f not handled, try acia 

C1AF:4C 84 C7 94 jmp swrts2 ;Back we go 
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C 1 F8 : 10 06 C200 

C 1 FA : 8E FF 05 
C 1 FD : 8E FF 06 
C200 : AD 10 C0 
C203 : 

C203: C 1 42 

C203 : A0 B0 

C205 : B9 F9 BF 

C208 : 29 BF 

C20A : 0A 

C20B : 0 A 

C20C : 29 20 

C20E.-F0 3E C24E 

C210:B9 FA BF 

C2 13 : 49 01 

C2 1 5 : 29 03 

C2 1 7 : D0 35 C24E 

C2 1 9 : 8A 

C2 1 A : 4 D FF 04 

C2 1 D : D0 93 C1B2 

C2 1 F : 08 

C220 : 20 22 C3 

C223 : 90 28 C24D 

C225 : A0 00 

C227 : D0 

C228 : C228 

C228 : 08 

C229 : DA 

C22A : 48 

C22B : B9 7F 05 

C22E : AA 

C22F : 1 A 

C230 : 89 7F 

C232 : D0 01 C235 

C234 : 98 

C235 : D9 7F 06 

C238 : F 0 03 C23D 

C23A : 99 7F 05 

C23D : 68 

C23E : 2C 14 C0 

C24 1 : 8D 05 C0 

C244 : 9D 00 08 

0247:30 03 C24C 

C249 : 8D 04 00 

C24C : F A 

C24D : 28 

C24E : 60 


Mouse & serial interrupt stuff 


167 


bp 1 

ainof lsh 

168 


stx 

twkey 

169 


stx 

trkey 

170 

ainof lsh 

1 da 

kbds trb 

171 

• «A0 $B0 

table 

needed by 

172 

devno2 

equ 

• -s 1 tdmy 

173 


ldy 

#$B0 

174 


Ida 

35 tat ,y 

175 

aieat 1 t 

and 

#$BF 

176 

aipass 

as 1 

A 

177 


as 1 

A 

178 


and 

#$20 

179 


beq 

aciadone 

180 


Ida 

scomd , y 

181 


eor 

#1 

182 


and 

#3 

183 


bne 

aciadone 

184 


txa 


185 


eor 

aciabuf 

186 


bne 

notac ia 

187 


php 


188 


J 3 r 

getdata 

189 


bcc 

aieat 

190 


ldy 

#0 

191 


dfb 

$D0 

192 

putbuf 

equ 

• 

193 


php 


194 


phx 


195 


pha 


196 


Ida 

twser , y 

197 


tax 


198 


i nc 

A 

199 


bit 

#$7F 

200 


bne 

pbok 

201 


tya 


202 

pbok 

cmp 

trser ,y 

203 


beq 

pbfull 

204 


sta 

twser , y 

205 

pbfull 

pla 


206 


bit 

r dramwr t 

207 


sta 

wr car dram 

208 


sta 

thbuf , x 

209 


bmi 

aiaux 

210 


sta 

wrmainram 

211 

alaux 

plx 


212 

aieat 

pip 


213 

aciadone 

rts 



{Flush the type ahead buffer 

{Clear the keyboard 
al firmware 

{Restore y 

{Read status to clear int 
{Clear the DSR bit 
{Shift DSR into C 

{Is the receiver full? 

{If not, we're done 

{Are receive interrupts enabled? 

{Check for D<1>,D<0> - 01 

{If not , were done 
{Is this acla buffered? 

{The user better handle it! 

{Save DSR status 
{Get char $ check xon, etc 
{Don't put in buffer if eaten 

{ BNE opcode to skip PHP 


{Get buffer pointer 
{Save it for later 
{Bump it to next free byte 
{Overflow? 

{Wrap pointer 
{Buffer full? 

{Save the new pointer 
{Get the data 

{ I t goes to aux ram 

{Branch if we want aux 


{Get DSR status back 
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C24F : 



215 





C24F : 



216 

* 




C24F: 



217 

• SER0UT3 

- Outputs a character to a acia 

C24F : 



218 

• Inputs: 

A - 

char , X ■ On 


C24F : 



219 

* 




C24F : 



220 





C24F : 


C24F 

221 

serout3 

equ 

• 


C24F : 20 

55 

02 

222 


J 3r 

serout4 


C252 : 40 

84 

07 

223 


Jmp 

swr ts2 


C255: 


0255 

224 

ser ou 1 4 

equ 

• 

;Entry point with rts 

C255 : 48 



225 


pha 


;Save the char 

C256 : 2C 

AB 

02 

226 


bit 

sorts 

; Control char? 

C259: F0 

03 

C25E 

227 


beq 

sordy 

{ Don ' t Inc column if so 

C25B: FE 

38 

07 

228 


1 nc 

col , X 


C25E : 20 

B2 

02 

229 

sordy 

jar 

gets tat2 

{Get acia status 

C26 1 : 29 

30 


230 


and 

#$30 

;Y set by getstat 

C263:C9 

10 


231 


cmp 

#$10 


C265 : D0 

F7 

C25E 

232 


bne 

sordy 


C267 : BD 

B8 

06 

233 


Ida 

flags ,x 

; I 5 X0N/X0FF enabled? 

C26A : 89 

20 


234 


bit 

#$20 


C26C : F 0 

IF 

C28D 

235 


beq 

sook 

{Branch if not 

C26E : EC 

FF 

04 

236 


cpx 

aciabuf 

;Is port interrupt driven? 

C27 1 : F0 

13 

0286 

237 


beq 

sotst 


C273 : 20 

E9 

02 

238 


J sr 

xrdnobuf 

;Get a char from the acia 

C276 : 90 

0E 

0286 

239 


bcc 

sotst 

;Branch if no char 

C278 : BC 

34 

02 

240 


ldy 

charptr , x 

;Get pointer to charbuf 

C27B : 99 

FE 

05 

241 


9 t a 

charbuf , y 

{Save the character 

C27E : BD 

B8 

06 

242 


Ida 

f laqs , x 

;Set bit for char in buffer 

C28 1 : 09 

04 


243 


ora 

#$04 


C283 : 9D 

B8 

06 

244 


a ta 

flags , x 


C286 : BD 

B8 

06 

245 

sotst 

Ida 

flags , x 

; Check if in xoff 

C289 : 29 

02 


246 


and 

#$02 


C28B : D0 

D 1 

C25E 

247 


bne 

sordy 

;Loop if not ready 

C28D : BC 

42 

01 

248 

sook 

ldy 

devno2 , x 


C290 : 68 



249 


pla 



C29 1 : 48 



250 


pha 


;Get char to XMIT 

0292 : 99 

F8 

BF 

251 


s ta 

sdata.y 

;0ut it goes 

C29S : 3C 

B8 

06 

252 


bit 

flags ,x 

; V- 1 if LF after OR 

0298:49 

0D 


253 


eor 

#$0D 

; check for OR. 

C29A : 0A 



254 


as 1 

A 

{preserve bit 7 

C29B : D0 

0D 

C2AA 

255 


bne 

sodone 

{branch if not OR. 

C29D : 50 

06 

C2A5 

256 


bvc 

clrcol 

{branch if no LF after OR 

C29F : A9 

14 


257 


1 da 

#$14 

{Get LF«2 

C2A1 :6A 



258 


ror 

A 

; no shift in high bit 

C2A2 : 20 

55 

02 

259 


J 3r 

serou t4 

{Output the LF but don't echo 

C2A5 : 64 

24 


260 

c 1 r col 

stz 

ch 

{0 position 4 column 

C2A7 : 9E 

38 

07 

261 


stz 

col , X 


C2AA : 68 



262 

sodone 

pla 


{Get the char back 

C2AB : 60 



263 

sorts 

rts 




C2AC 

C2AC 

C2AC 

C2AC 

C2AC 

C2AC 

C2AC 

C2AC 

C2AC 




265 

266 

267 

268 

269 

270 

271 

272 

273 

• GETSTAT - Gets the status 

• GETSTAT2 - Call from this 

• If interrupt, aciatst is 

• note: external interrupts 

• inputs: X - On 

• outputs: A - status, X ■ 

from a 
side 
called 
are lo 

On, Y - 

acia 

at 

devno 











C2AC 



C2AC 

275 

getstat 

equ 

• 



C2AC 

20 

B2 

02 

276 


J 3r 

gets tat2 



C2AF 

40 

84 

07 

277 


Jmp 

swr ts2 

{Return to other side 

C2B2 



C2B2 

278 

ge t s ta 1 2 

equ 

• 



C2B2 

08 



279 


php 


{Save interrupt status 

C2B3 

78 



280 


sei 




C2B4 

BC 

42 

01 

281 

gsttst 

ldy 

devno2 , x 

{Get 

index into hardware 

C2B7 

B9 

F9 

BF 

282 


Ida 

astat , y 

{Get 

the status 

C2BA 

10 

05 

C2C1 

283 


bpl 

gstnoint 

;D7 

1 if interrupt 
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C2BF-80 F3 C 1 C2B4 111 ;Go 5ervlce the interrupt 

p?ri • ffl F3 C2B4 OOC * . ♦ b i a 9 sttst ; Interrupt may have changed status 

C 1«;IS Ilf 95t "°‘ nt fiS Interrupt et.tS, 
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C2C3: 



289 





C2C3: 



290 

• This 

is the 

serial input 

routine. Carry 

C2C3 : 



291 

• flaq set indicates that returned data is 

C2C3: 



292 

• valid. 




C2C3: 



293 

• 




C2C3: 



294 





C2C3: 


C2C3 

295 

xrdser 

equ 

• 


C2C3 : 20 

C9 

C2 

296 


jsr 

xrdser 2 


C2C6 : 4C 

84 

C7 

297 


Jmp 

swr t s 


C2C9: 


C2C9 

298 

xrdser 2 

equ 

• 


C2C9 : EC 

FF 

04 

299 


cpx 

ac iabuf 

;ls serial input buffered? 

C2CC : D0 

07 

C2D5 

300 


bne 

xnosbuf 

; ( i n english "NO SERIAL BUFFER") 

C2CE : A0 

00 


30 1 


ldy 

'0 

; Y-0 for serial buffer 

C2D0 : 20 

FD 

C2 

302 


jsr 

ge tbuf 2 

{Any data in buffer? 

C2D3 : B0 

IF 

C2F 4 

303 


bcs 

xrddone 


C2D5: 



304 

• 




C2D5 : BD 

B8 

06 

305 

xnosbuf 

Ida 

flags , x 

;Is there a char in the onr byte 








buffer? 

C2D8 : 89 

04 


306 


bit 

#*0 4 


C2DA : F 0 

0D 

C2E9 

307 


beq 

xrdnobuf 

;Branch if not 

C2DC : 29 

FB 


308 


and 

#*FB 

; Clear the bit 

C2DE : 9D 

B8 

06 

309 


s ta 

flags , x 


C2E 1 : BC 

34 

C2 

310 


1 dy 

charptr , x 


C2E4 : B9 

FE 

05 

31 1 


Ida 

charbuf , y 


C2E7 : 38 



312 


sec 



C2E8 : 60 



313 


r ts 



C2E9 : 



314 

• 




C2E9 : 20 

B2 

C2 

315 

xrdnobuf 

Jsr 

getstat2 

;Get ACIA status 

C2EC : 29 

08 


316 


and 

#*8 


C2EE: 18 



317 


clc 


; indicate no data 

C2EF : F0 

03 

C2F4 

318 


beq 

xrddone 

;Branch if no data! 

C2F 1 : 20 

22 

C3 

319 


jsr 

getdata 

;Get data and check xon, etc 

C2F 4 : 60 



320 

xrddone 

r t s 



C2F5: 


C234 

322 

char ptr 

equ 

•-*C1 

;Pointer to character buffers 

C2F5 : 00 

80 


323 


dfb 

*0,180 



C2F7 : 



325 





C2F7 : 



326 





C2F7 : 



327 

• GETBUF 

- Gets 

a byte fr 

om the input buffer 

C2F7 : 



328 

• Inputs 

: Y-0 f< 

Dr Serial 

buffer 80 for Keyboard buffer 

C2F7 : 



329 

• C - 0 

if no data C ■ 1 

if data valid A - Data 

C2F7 : 



330 





C2F7 : 



331 





C2F7 : 


C2F7 

332 

getbuf 

equ 

• 


C2F7 : 20 

FD 

C2 

333 


J 9r 

getbuf 2 


C2FA : 4C 

84 

C7 

334 


jmp 

swr ts 


C2FD: 


C2FD 

335 

getbuf 2 

equ 

• 


C2FD : B9 

7F 

06 

336 


Ida 

trser , Y 

{Test for data in buffer 

C300 :D9 

7F 

05 

337 


cmp 

twser , Y 

; I f - then no data 

C303: 18 



338 


clc 



C304 : F 0 

IB 

C32 1 

339 


beq 

gbdone 

{Branch if empty 

C306 : 48 



340 


pha 


{Save current value 

C307 : 1 A 



34 1 


inc 

A 

{Update the pointer 

C308 : 89 

7F 


342 


bit 

#*7F 

; Overflow 

C30A : D0 

01 

C30D 

343 


bne 

gbnoovr 


C30C : 98 



344 


tya 



C30D : 99 

7F 

06 

345 

gbnoovr 

sta 

trser ,y 

{Store the updated pointer 

C3 1 0 : 7A 



346 


ply 


{Get the old value of the pointer 

C31 1 : AD 

13 

C0 

347 


Ida 

rdramrd 

{Are we in main ram 

C3 1 4 : 0 A 



348 


as 1 

A 

; C- 1 for Aux ram 

C3 1 5 : 8D 

03 

C0 

349 


sta 

rdcardram 

{Force Aux ram 

C3 1 8 : B9 

00 

08 

350 


Ida 

thbuf ,Y 

{Get byte from buffer 

C3 1 B : B0 

04 

C32 1 

351 


bcs 

gbdone 

{Branch if we were in aux bank 

C31D.-8D 

02 

C0 

352 


sta 

rdmal nram 

{Set back to main 

C320 : 38 



353 


sec 


{Mark data there 

C32 1 : 60 



354 

gbdone 

rts 
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C322: 356 

C322: 357 * 

C322: 358 • GETDATA - Gets data from serial port 

C322: 359 • and checks for LF , XON, XOFF 

C322: 360 * inputs: Y • index to acia 

C322: 361 • outputs: A ■ data, Y dest, C • 1 if data ok « 0 if eaten 


C322: 



362 

• 












C322 : 


C322 

364 

getdata 

equ 

• 


C322 : B9 

F8 

BF 

365 


Ida 

sdata , y 


C325 : 48 



366 


pha 


{Save the data 

C326 : 09 

80 


367 


ora 

#*80 

{Set D7 for compares 

C328 : A8 



368 


tay 



C329 : BD 

B8 

06 

369 


Ida 

flags , x 

{Get options byte 

C32C : 89 

08 


370 


bit 

#*08 

{Eat linefeeds? 

C32E : D0 

04 

C334 

371 


bne 

gdno 1 f 


C330 :C0 

8A 


372 


cpy 

# 1 feed 

;Is it a LF? 

C332 : F 0 

12 

C346 

373 


beq 

gdea t 

{Eat it if it is 

C334 : 89 

20 


374 

gdno 1 f 

bit 

#*20 

; Xon/ XOFF enabled? 

C336 : F 0 

10 

C348 

375 


beq 

gdok 


C338 : C0 

91 


376 


cpy 

#xon 

{Is it an XON? 

C33A : D0 

04 

C340 

377 


bne 

gdnxon 


C33C : 29 

FD 


378 


and 

#*FD 

{Clear xoff bit 

C33E : 80 

06 

C346 

379 


bra 

gdeat 

{And eat it 

C340 : C0 

93 


380 

gdnxon 

cpy 

#xo f f 


C342 : D0 

04 

C348 

381 


bne 

gdok 


C344 : 09 

02 


382 


ora 

#*02 

{Set xoff bit 

C346 : 18 



383 

gdeat 

clc 



C347 : B0 



384 


dfb 

*B0 

;BCS opcode 

C348 : 38 



385 

gdok 

sec 



C349 : 9D 

B8 

06 

386 


5 ta 

flags , x 


C34C : 68 



387 


pla 



C34D : 60 



388 


rts 



C34E : 



52 


Include auxstuff 

{Auxiliary move stuff 



23 AUXSTUFF 
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C34E: 

C34E: 

C34E : 

C34E : 

C34E : 

C34E : 

C34E : 

C34E: 

C34E: 

C34E : 

C34E : 

C34E : 

C34E : C34E 

C34E : 48 

C34F : AD 13 C0 

C352 : 48 

C353 : AD 14 C0 

C356 : 48 

C357 : 

C357 : 

C357 : 

C357 : 90 08 C361 

C359 : 8D 02 C0 
C35C : 8D 05 C0 
C35F : B0 06 C367 

C36 1 : 

C36 1 : C361 

C361 : 8D 04 C0 
C364 : 8D 03 C0 
C367: 

C367 : C367 

C367 : B2 3C 

C369 : 92 42 

C36B : E6 42 

C36D : D0 02 C371 

C36F : E6 43 

C37 1 : A5 3C 

C373 : C5 3E 

C375 : A5 3D 

C377 : E5 3F 

C379 : E6 3C 


C37B : D0 02 C37F 
C37D : E6 3D 
C37F : 90 E6 C367 
C38 1 : 

C38 1 : 8D 04 C0 
C384 : 68 

C385 : 1 0 03 C38A 
C387 : 8D 05 C0 
C38A: C38A 

C38A : 8D 02 C0 
C38D : 68 

C38E : 1 0 03 C393 

C390 : 8D 03 C0 
C393: C393 

C393 : 68 
C394 : 4C 84 C7 


NAME 

FUNCTION 

INPUT 


OUTPUT 

VOLATILE 

CALLS 


MOVEAUX 

PERFORM CROSSBANK MEMORY MOVE 
A 1 "SOURCE ADDRESS 
A2-S0URCE END 
A4 -DESTI NATI ON START 
CARRY SET-MA I N« >CARD 
CLR-CARD->MAIN 

NONE 

NOTHING 

NOTHING 


OVEAUX EQU • 

PHA . cayr ar 

LDA RDRAMRD -SAVE STATE OF 

PHA ; MEMORY FLAGS 

LDA RDRAMWRT 

PHA 

SET FLAGS FOR CROSSBANK MOVE: 

BCC MOVEC2M 5 ->CARD- >MA I N 

STA RDMAINRAM ;SET FOR MAIN 

STA WRCARDRAM ; TO CARD 

BCS MOVESTRT ;-><ALWAYS TAKEN) 


MOVESTRT EQU 
MOVELOOP LDA 


STA 

PLA 

BPL 

STA 

C03 EQU 

STA 
PLA 
BPL 
STA 

MOVERET EQU 
PLA 
JMP 


(AIL) 

(A4L) 

A4L 

NEXTA1 

A4H 

AIL 

A2L 

A 1 H 

A2H 

AIL 

COI 

MOVELOOP 


WRCARDRAM 


CLEAR FLAG2 

GET ORIGINAL STATE 

“ > I T WAS OFF 


CLEAR FLAG 1 

GET ORIGINAL STATE 

■ > I T WAS OFF 


4 ^ 


CO 


CO 


23 AUXSTUFF 
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24 BANGER2 


Appl 

e //c dia 

gnostics 

26- JUL-85 PAGE 87 

24 BANGER2 


Appl 

e //c diagnost 1 

cs 
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C3C6: 



3 





0441 :D0 

EE 

0431 

74 

bne 

memA 

{branch if not 

C3C6: 



4 

• 




0443 : E6 

01 


75 

1 nc 

1 

;bump page ' 

C3CG: 



S 

• Here la 

the 

rest of the 

diagnostic stuff 

0445 : D0 

CB 

0412 

76 

bne 

mem7 

{loop through $0100 to $FF00 

C3C6: 



6 

* the first pa 

rt has been 

moved into the $D000 space 

0447 :6A 



77 

ror 

a 


C3C6: 



7 

* to make 

desp 

erately needed room 

0448:20 

19 

00 

78 

bit 

rdvbl bar 

; use RDVBL for a little 

C3CG: 



8 

# 










randomness . . . 

C3C6 : 



9 





C44B : 10 

02 

C44F 

79 

bp 1 

memC 


C3C6 : 


C3C6 

10 

TSTMEM 

equ 

* 


C44D : 49 

A5 


80 

eor 

'$ A5 


C3C6 : 86 

01 


1 1 


9 t X 

$01 


C44F : 06 

04 


81 

memC dec 

$04 

{have 5 passes been done yet 

C3C8 : 86 

02 


12 


stx 

$02 


0451:30 

03 

0456 

82 

bmi 

memD 


C3CA:86 

03 


13 


stx 

$03 


0453:40 

D0 

03 

83 

Jmp 

meml 


C3CC : A2 

04 


14 


ldx 

<-4 

; do RAM $100-$FFFF five times 








C3CE : 86 

04 


15 


stx 

$04 









C3D0 : 85 

05 


16 

MEM1 

STA 

$05 

;keep acc in a safe place 

0456: AA 



85 

memD TAX 



C3D2 : A2 

04 


17 


ldx 

#4 


0457:20 

13 

00 

86 

BIT 

rdramr d 


C3D4 : 64 

01 


18 


stz 

$01 


C45A : 30 

10 

C46C 

87 

BMI 

MEMF 


C3D6 : E6 

01 


19 


i nc 

1 

;point to page 1 first 

C45C : 8A 



88 

txa 



C3D8: A8 



20 

mem2 

tay 


;save ACC in Y for now 

C45D : 8D 

05 

00 

89 

STA 

wr car d ram 


C3D9 : 8D 

83 

00 

21 


5 tfl 

1 cbank2 

{anticipate not $0000 range... 

0460 : 8D 

03 

00 

90 

STA 

rdcardram 

{enable aux mem read 

C3DC : 8D 

83 

00 

22 


s ta 

1 cbank 2 


0463 : 8D 

09 

00 

91 

STA 

se tal t zp 


C3DF : A5 

01 


23 


Ida 

$01 

{get page address 

0466 : 8D 

81 

00 

92 

STA 

ROM 1 N 

{Force rom enable 

C3E 1 : 29 

F 0 


24 


and 

'$F0 

{test for $C0-$CF range 

0469:40 

B2 

D4 

93 

Jmp 

TSTZPG 


C3E3 : C9 

00 


25 


cmp 

'$00 









C3E5 : D0 

00 

C3F3 

26 


bne 

mem3 

; branch if not . . . 

C46C : 8D 

08 

00 

95 

MEMF STA 

setstdzp 

{swap in main zero page 

C3E7 : AD 

8B 

00 

27 


Ida 

lcbank 1 


C46F : 40 

EF 

04 

96 

JMP 

SWCHTST 


C3EA: AD 

8B 

00 

28 


1 da 

lcbank 1 

;select primary $D000 space 








C3ED : A5 

01 


29 


1 da 

$01 









C3EF : 69 

0F 


30 


adc 

'$F 

{Plus carry -*$10 








C3F 1 :D0 

02 

C3F5 

31 


bne 

mem4 

{branch always taken 








C3F3 : AS 

0 1 


32 

mem3 

Ida 

$01 









C3F5 : 85 

03 


33 

mem4 

s ta 

$03 









C3F7 : 98 



34 


tya 


jrestore pattern to ACC 








C3F8 : A0 

00 


35 


ldy 

'$00 

; f i 1 1 this page with the pattern 








C3F A : 18 



36 

nemS 

clc 










C3FB : 7D 

2A 

08 

37 


adc 

ntbl , x 









C3FE : 9 1 

02 


38 


a ta 

($02) ,y 









C400 :CA 



39 


dex 


;keep x in the range 0-4 








C401 : 10 

02 

0405 

40 


bpl 

mem6 









C403 : A2 

04 


41 


ldx 

'4 









C405 : C8 



42 

mem6 

i ny 


; a 1 1 256 filled yet? 








C4 06 : D0 

F 2 

C3F A 

43 


bne 

mem5 

;branch if not 








C4 08 : E6 

01 


44 


1 nc 

1 

;bump page ' 








04 0 A : D0 

CC 

C3D8 

45 


bne 

mem2 

;loop through $0100 to $FF00 








C40C : E6 

01 


47 


inc 

$01 

;polnt to page 1 again 








C40E : A2 

04 


48 


LDX 

'4 









C410: AS 

05 


49 


LDA 

$05 









0412: A8 



50 

mem7 

tay 


;save ACC in Y for now 








C4 1 3 : AD 

83 

00 

51 


Ida 

1 cbank 2 

anticipate not $0000 range... 








C4 16 : AD 

83 

00 

52 


Ida 

lcbank2 









C4 19 : A5 

01 


53 


Ida 

$01 

;get page address 








C4 1 B : 29 

F 0 


54 


and 

MF0 

;test for $C0-$CF range 








C41D:C9 

00 


55 


cmp 

'$00 









C4 1 F : D0 

09 

C42A 

56 


bne 

mem8 

{branch if not . . . 








C42 1 : AD 

8B 

00 

57 


Ida 

lcbank 1 

{select primary $D000 space 








C424 : A5 

01 


58 


Ida 

$01 









0426:69 

0F 


59 


adc 

'$F 

{Plus carry -*$10 








0428 :D0 

02 

C42C 

60 


bne 

mem9 

{branch always taken 








C42A : A5 

01 


61 

mem8 

Ida 

$01 









C42C : 85 

03 


62 

mem9 

sta 

$03 









C42E : 98 



63 


tya 


{restore pattern to ACC 








C42F : A0 

00 


64 


ldy 

'$00 

{fill this page with the pattern 








0431 : 18 



65 

memA 

clc 










0432 : 7D 

2A 

08 

66 


adc 

ntbl ,x 









C43S : S 1 

02 


67 


eor 

($02), y 









0437 : D0 

39 

0472 

68 


bne 

MEMERR0R 

{if any bits are different, give 








0439: B1 

02 


69 


Ida 

($02), y 

up! ! ! 

{restore correct pattern 








C43B : CA 



70 


dex 


{keep x in the range 0-4 








C43C : 10 

02 

0440 

71 


bpl 

memB 









C43E : A2 

04 


72 


ldx 

'4 









0440:08 



73 

memB 

1 ny 


{all 256 filled yet? 










24 BANGER2 


Appl 

e //c dia 

gnost i cs 
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I 24 BANGER2 


Appl 

e // c diagnostl 

cs 

0472 : 38 



98 

MEMERR0R 

sec 


{indicate main ram failure 

C4CA : A2 

02 


143 

BADSWTCH 

ldx 

#2 

C473 : AA 



99 

BADBITS 

tax 


{save bit pattern in x for now 

C4CC : 7A 



144 


ply 


C474 : AD 

13 

00 

100 


1 da 

r dramr d 

;main or aux mem? 

C4CD: 08 



145 


php 


C477 : B8 



101 


civ 


{with V-FLG 

C4CE : BD 

60 

08 

146 

bswtchl 

1 da 

smess x 

C478 : 10 

03 

C47D 

102 


bpl 

bbl tsl 

{branch if primary bank 

C4D 1 : 28 



147 


pip 


C47A : 2C 

2A 

08 

103 


bit 

set v 


C4D2 : 08 



148 


php 


C47D : A9 

A0 


104 

bbl tsl 

1 da 

#$A0 

{try to clear video screen 

C4D3 : 90 

03 

C4D8 

149 


bcc 

bsw t ch2 

C47F : A0 

06 


105 


1 dy 

*6 


C4D5 : BD 

6F 

08 

150 


1 da 

smess*3 , j 

C48 1 : 99 

FE 

BF 

106 

clrsts 

s ta 

i oadr -2 , y 


C4D8 : 00 

06 


151 

bswtch2 

cpy 

#6 

C484 : 99 

06 

00 

107 


s ta 

i oadr *6 , y 


C4DA : 90 

0B 

C4E7 

152 


bcc 

bswtch3 

C487 : 88 



108 


dey 



C4DC : 00 

08 


153 


cpy 

#8 

0488:88 



109 


dey 



C4DE : 90 

04 

C4E4 

154 


bcc 

bswtch2a 

C489 : D0 

F6 

0481 

110 


bne 

clrsts 









C48B : 8D 

51 

00 

1 1 1 


s ta 

txtset 


C4E0 : 00 

1 1 


155 


cpy 

#$ 1 1 

C48E : 8D 

54 

00 

1 12 


s ta 

t x t page 1 


C4E2 :90 

03 

C4E7 

156 


bcc 

bswtch3 

C49 1 : 99 

00 

04 

1 13 

clrs 

s ta 

$400, y 


C4E4 : BD 

72 

08 

157 

bswtch2a 

Ida 

smess+6 , i 

0494:99 

00 

05 

1 14 


s ta 

$500 , y 


C4E7 : 9D 

B8 

05 

158 

bswtch3 

s ta 

screen ,x 

0497:99 

00 

06 

1 IS 


s ta 

$600 ,y 


C4EA : CA 



159 


dex 


C49A : 99 

00 

07 

1 16 


s ta 

$700, y 


C4EB: 10 

El 

C4CE 

160 


bpl 

bswtchl 

C49D : 08 



117 


i ny 



C4ED: 30 

FE 

C4ED 

161 

hangy 

bml 

angy 

C49E : D0 

FI 

0491 

1 18 


bne 

clrs 









C4A0 : 8A 



1 19 


t xa 


{test for switch test failure 








C4A1 :F0 

27 

C4CA 

120 


beq 

BADSWTCH 

{branch if it was a switch 

C4EF : A0 

01 


163 

SWCHTST 

1 dy 

#MMU I DX 

C4A3 : A0 

03 


121 


1 dy 

#3 


C4F 1 :A9 

7F 


164 

swts 1 1 

Ida 

#$7F 

C4A5-.B0 

02 

C4A9 

122 


bcs 

badmain 

{branch if ZP ok 

C4F3 : 6A 



165 

swts t2 



C4A7 : A0 

05 


123 


1 dy 

#5 









C4A9: A9 

AA 


124 

badmain 

Ida 

#$AA 

{mark aux report with an asterisks 

C4F 4 : BE 

2F 

08 

166 


1 dx 

SWTBL0 , y 

04 AB : 50 

03 

C4B0 

125 


bvc 

badpr im 


C4F7 : F 0 

0 F 

0508 

167 


beq 

swtst4 

04 AD : 8D 

B0 

05 

126 


s ta 

screen-8 


C4F9 : 90 

03 

C4FE 

168 


bcc 

swtst3 

C4B0-.B9 

66 

08 

127 

badpr im 

Ida 

rmess , y 


C4FB : BE 

41 

08 

169 


ldx 

SWTBL1 , y 

C4B3 : 99 

B 1 

05 

128 


s ta 

screen-7, y 


C4FE : 9D 

FF 

BF 

170 

swts t3 

s ta 

1 oadr - 1 , j 

C4B6 : 88 



129 


dey 



0501 :C8 



171 


i ny 


C4B7 : 10 

F7 

C4B0 

130 


bpl 

badpr im 

{message is either "RAM" or "RAM ZP" 

0502 : D0 

EF 

C4F3 

172 


bne 

swtst2 

C4B9 : A0 

10 


131 


1 dy 

#$10 

{print bits 

0504: 



173 

• 



C4BB : 8A 



132 

bbl ts2 

t xa 



0504 : AE 

30 

00 

174 

click 

ldx 

s _ k r 

C4BC : 4 A 



133 


lsr 

a 


CS07:2A 



175 


rol 

a 

C4BD : AA 



134 


tax 



0508:88 



176 

swts t4 

dey 


C4BE : A9 

58 


135 


1 da 

#$58 

{bits are printed as ascii 0 or 1 

0509 : BE 

53 

08 

177 


ldx 

RSWTBL.y 

C4C0 : 2A 



136 


r ol 

a 


C50C : F 0 

13 

0521 

178 


beq 

swtst6 

0401:99 

B6 

05 

137 


s ta 

screen-2 ,y 


C50E : 30 

F4 

0504 

179 


bml 

click 

0404:88 



138 


dey 










0405:88 



139 


dey 



05 1 0 : 2A 



180 


rol 

a 

C4C6:D0 

F3 

C4BB 

140 


bne 

bbits2 


0511 : 90 

07 

05 1 A 

181 


bcc 

swtst5 

C4C8 : F0 

FE 

C4C8 

141 

hangx 

beq 

hangx 

{hang forever and ever 

0513: IE 

00 

00 

182 


as 1 

i oadr , x 









0516:90 

IF 

0537 

183 


bcc 

swer r 









05 1 8 : B0 

EE 

0508 

184 


bcs 

swtst4 









C51A: IE 

00 

00 

185 

swts t5 

as 1 

ioadr , x 









05 1 D : B0 

18 

0537 

186 


bcs 

swer r 









05 1 F : 90 

E7 

0508 

187 


bcc 

swtst4 









0521 : 



188 

• 











0521 :2A 



189 

swtst6 

rol 

a 









0522:08 



190 


1 ny 










0523:38 



191 


sec 










0524 : E9 

01 


192 


sbc 

#1 









0526 : B0 

CB 

C4F3 

193 


bcs 

SW t 5 t 2 









0528:88 



194 


dey 










0529 : F 0 

08 

0533 

195 


beq 

5 W t 5 t 7 









C52B : 00 

08 


196 


cpy 

#iouidx- 









C52D : D0 

10 

CS3F 

197 


bne 

BIGL00P 









C52F : A0 

1 1 


198 


1 dy 

#GLU I DX 









0531 :D0 

BE 

C4F 1 

199 


bne 

swtst 1 









0533 : A0 

09 


200 

swts t7 

1 dy 

# I 0U I DX 









0535 : D0 

BA 

C4F 1 

201 


bne 

swtst 1 









0537: 



202 

• 











0537 : 5A 



203 

swer r 

phy 










0538 : A2 

00 


204 


ldx 

#0 









C53A : 00 

0 A 


205 


cpy 

# I 0U I DX ♦ 









C53C : 40 

7D 

04 

206 


Jmp 

bbl ts 1 
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{anticipate MMU error 


;branch If not IOU error 
{anticipate IOU error 
{compare with where we left off 
{skip If MMU 

{skip If GLU (loudls or dhlres 
failure) 


{skip if IOU 

{GLU error (loudls failure) 


{print "MMU" , "IOU" or "GLU" 
{branch forever 


{set switches of the IOU/MMU to 
match Accumulator 

{branch If done setting switches 
{branch If setting switch to 0-state 
{else get index to set switch to 1 
;set switch 

{branch always taken... 


now verify the settings just made 
branch if done this pass 
branch if this switch no to be 
verified. 


{branch always 


{branch always 

{restore original value 
; and IOU/MMU index 

{try next pattern 

{ was MMU just tested? 

{yes, go test IOU 
; was IOU just tested? 

{no, go loop again 

;yes, go test IOUDIS switch 

{branch always 

{branch always 

{save y to distinguish from MMU or 
GLU failure 

{indicate switch error 
;set carry if IOU was cause 


CO 



24 BANGER2 


Appl 

e //c 

diagnos 1 1 

C 3 
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C53F : 46 

80 


208 

BIGLOOP lsr 

*80 


C54 1 : D0 

AC 

C4EF 

209 


bne 

SWCHTST 


C543 : A9 

A0 


210 

b 1 p2 

Ida 

#*A0 


C545 : A0 

00 


211 


ldy 

#0 


C547 : 99 

00 

04 

212 

b 1 p3 

s t a 

*400 ,y 

jclear screen for success message 

C54A : 99 

00 

05 

213 


s ta 

*500, y 


C54D : 99 

00 

06 

214 


s ta 

*600, y 


C550 : 99 

00 

07 

215 


s ta 

*700 , y 


C553 : C8 



216 


1 ny 



C554 : D0 

FI 

C547 

217 


bne 

blp3 


CSS6: AD 

61 

C0 

218 

b 1 p4 

LDA 

butn0 

;test for both Open and Closed Appl 

C559 : 2D 

62 

C0 

219 


AND 

butnl 

; pressed 

C55C : 0 A 



220 


asl 

a 

;put result in carry 

C55D: E6 

FF 


221 


INC 

*FF 


C55F :A5 

FF 


222 


LDA 

*FF 


C56 1 : 90 

03 

C566 

223 


bcc 

dqui t 


C563 : 4C 

A9 

D4 

224 


Jmp 

DIAGS 


C566: 



225 

• 




C566 : AD 

SI 

C0 

226 

dqui t 

1 da 

txtaet 

;put success message on the screen 

C569 : A0 

08 


227 


ldy 

#8 


C56B : B9 

75 

C8 

228 

suc2 

Ida 

success ,y 


C56E : 99 

B8 

05 

229 


s ta 

SCREEN, y 


C571 :88 



230 


dey 



C572 : 10 

F7 

C56B 

231 


bpl 

suc2 


C574 : 30 

E0 

C556 

232 


bml 

b 1 p4 

; loop forever 

C576: 


000A 

54 


da 

*C580 - * , 0 

;Appletalk stuff 

C580 : 



55 


include switcher2 

;Bank switch stuff § 2:C780 


25 SWITCHER2 


Apple //c diagnostics 


26- JUL-85 


PAGE 92 




25 SWITCHER2 


Apple //c diagnostics 
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C81F : 2C 11 C0 73 bit rdlcbnk2 {Bank 2? 

C822 : 1 0 02 C826 74 bpl glcbnkl 

C824 : A0 83 75 ldy '$83 ;Bank 1! 

C826:8D 81 C0 76 glcbnkl sta romin 

C829 : 60 77 glcdone rts 


C82A: 79 * Diagnostic routine tables 

C82A : C82A 80 setv equ * 

C82A : 53 43 2B 29 81 ntbl dfb 83,67,43,41,7 

C82F : 0 0 89 03 05 82 swtbl0 dfb $00 , $89 , $03 , $05 , $09 , $0 1 , $7F , $5F 

C837 : 0 0 83 51 53 83 dfb $ 0 0 , $83 , $5 1 , $53 , $55 , $57 , $ 0F , $ 0D , $ 0 0 , $80 

C84 1:00 81 04 06 84 swtbll dfb $00 , $8 1 , $04 , $06 , $0A , $02 , $7F , $60 

C849 : 0 0 84 52 54 85 dfb $ 00 , $84 , $52 , $54 , $56 , $58 , $ 1 0 , $0E , $ 0 0 , $ 7F 

C853 : 00 1 1 13 14 86 rswtbl dfb $00 , $ 1 1 , $ 1 3 , $ 1 4 , $ 1 6 , $ 1 8 , $FF , $7F 

C85B : 00 12 1A IB 87 dfb $00 , $ 12 , $ 1 A , $ IB , $ 1C , $ ID, $ IE , $ 1 F , $00 , $7E , $00 

C866 : 88 MSB ON 

C866 : D2 Cl CD A0 89 rmess asc "RAM ZP" 

C86C : CD CD D5 C9 90 smess asc "MMU I OUGLU" 


C875:D3 F9 F3 F4 92 success asc "System OK" 

C87E : 0002 56 ds $C880-*,0 jProtocol converter 

C880 : 0780 57 ds $D000-*,0 

D000: 58 include command {Serial port command processor 


4 ^ 


CO 


CO 
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D000 : 
D000 : 
These 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 

D000 : 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 
D000 : 


D000 : 000D 

D000: 0000 

D0 0 0 : 48 
D0 0 1 : 3C B8 03 
D 0 0 4 : 3 0 1C D022 

D0 06 : BC 38 06 
D009: F0 14 D01F 

D00B : 5D 38 06 
D00E : 0A 

D00F : D0 0E D01F 

D0 1 1 : AC FB 07 
D0 1 4 : 8C 79 06 
D0 1 7 : A0 BF 
D0 19: 8C FB 07 
D0 1 C : 4C B5 D0 


D0 1 F : 38 
D020 : 68 
D02 1 : 60 

D022 : D022 

D022 : BC 42 Cl 
D025 : 29 5F 

D027 : 48 

D028 : BD B8 03 

D02B : 89 08 


D02D : D0 03 D032 

D02F : 68 

D030 : 80 52 D084 

D032 : D032 

D032 : 68 

D033 : 48 

D034 : C9 00 

D036 : D0 04 D03C 

D038 : 18 

D039 : 68 

D03A : 80 E4 D020 


D03C : BD B8 03 
D03F : 48 
D040 : 29 07 
D042 : 8D F8 06 

D045 : 68 
D046 : 29 F0 
D048 : 9D B8 03 


2 

3 


5 

6 

7 

8 
9 

10 
1 1 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

26 

27 


29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

43 

44 

45 

47 

48 

49 

50 

51 

52 

53 

54 

55 

57 

58 

59 

60 
61 
62 

63 

64 


66 

67 

68 

69 

70 

71 

72 


The command routine now supports 5 new 2-character commands. 

commands enable or disable a feature of the serial port and are 
derived from their equivalent in the super serial card for the//. 

The new commands are as follows: 

L - send LF out after CR 
X - detect XOFF , and wait for XON 
F - accept keyboard input 
M - ignore LF in after CR 

C - auto CR when column count > printer width 

Usage of location $779 (port 1) and $77A (port 2) are as 
f ol lows : 

bit 7 - echo output to screen if on 
bit 6 - generate LF after CR if on 
bit 5 - accept XOFF if on 
bit 4 - ignore keyboard input if on 
bit 3 - accept LF in after CR if on 

bit 2 - a character was received through the ACIA and is in 
location $5FE (port 1) or $67E (port 2) if on 
bit 1 - XOFF is accepted, awaiting XON if on 
bit 0 - signifies comm port if on, printer port if off 


charCR 

equ 

$0D 


ucspace 

equ 

$00 

;need an "upper case" space 
character 

command 

pha 


;shove character on stack 


bit 

sermode , x 

{Already in command? 


bmi 

1 ncmd 

; I f so , go do it 


ldy 

eschar , x 

; I f eschar ■ 0 ignore commands 


beq 

nocmd 


eor 

eschar , x 

;Is it the command char? 


as 1 

A 

; Ignore high bit 


bne 

nocmd 

;char not command char 

command 1 

ldy 

cursor 

{Save the cursor 


sty 

oldcur 



ldy 

'cmdcur 

{Set command cursor 


sty 

cursor 



jmp 

comini t 1 

{initiate command mode 

nocmd 

sec 


{Mark char not handled 

nocmd2 

pla 

rts 


{Restore original char 

1 ncmd 

equ 

• 

{Command mode 


ldy 

devno2 , x 

{Get index for ACIA 


and 

'$5F 

{High bit doesn't matter, upshift 
lower case 


pha 


{save character 


Ida 

sermode , x 

{need to see if in 2-chr command 


bit 

'$08 

{bit 3 set if so 


bne 

1 ncmd2 

{branch if so 


pla 


{pull char back, not in 2-chr cmd 


bra 

incmd 1 

;go on with regular command mode 


* {handle 2nd chr of 2-chr commands 

{pull char off stack 
; t reshove it to keep stack neat 
'ucspace ;is it a space? (uppercased) 

incmd3 ;no, go on with 2-chr cmd handling 

lyes, ignore spaces between chrs of 
2-chr cmds 

; pu 1 1 uppercased char off stack 
nocmd2 ;ie mark them "handled" 4 don't do 

anything else 


lncmd2 equ 

P la 

pha 

cmp 

bne 

clc 

pla 

bra 


incmd3 Ida sermode.x 
pha 

and '7 
sta temp 

pla 

and '$F0 
sta sermode.x 


get sermode back 

save sermode for a minlt 

throw out all but bits 0-2 

save - this is index of which cmd 

it is 

get sermode back 

now clear bits 0-3 

since we're done with them now 
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D0C5 : 

DBC5 : 38 
D0C6 : 90 
D0C7 : 

D0C7: 18 
D0C8 : 08 
D0C9 : E0 00 
D0CB : F 0 27 
D0CD : E0 04 
D0CF : F0 41 


D0D1 :8A 
D0D2 : 18 
D0D3 : 0A 
D0D4 : 69 03 
D0D6 : AA 
D0D7 : 28 
D0D8 : B0 01 
D0DA : E8 


D0DE : BD B8 03 
D0E 1 : 4 A 

D0E2 : B0 D 1 D0B5 
D0E4 : AD 79 06 
D0E7 : 8D FB 07 

D0EA : 08 
D0EB : IE B8 03 
D0EE : 28 
D0EF-.7E B8 03 
D0F2 : 68 
D0F3 : 60 

D0F4 : D0F4 

D0F 4 : A9 4C 
D0F6 : 28 

D0F7 : B0 96 D08F 

D0F9 : A9 4B 

D0FB : 80 92 D08F 

D0FD : 8A 
D0FE : FA 
D0FF : ID B8 03 
D 1 02 : 09 08 


144 enable equ • ;got a 2-chr command aE 

145 sec ;set carry 

1 46 dfb $90 ;bcc to skip next byte (the CLC) 

147 disable equ * ;got a 2-chr command aD 

148 clc jclear carry 

149 php ;push P to save carry 

150 cpx *0 ;if X-0 then command is LE or LD 

151 beq cmd2 1 {so Just make it act like L or K 

152 cpx #4 ; i f X-4 then command is CE or CD 

153 beq cmd.c {skip if so 


155 

156 • for other 2-chr cmds, their 

157 • for an E or 2X + 4 for a D 

158 


FLAGS masks' indexes are 2X+3 


168 xready Jmp 


176 cmset 

177 

178 

179 

180 
181 

183 cmd21 

184 

185 


190 cmd2found txa 

191 plx 

192 ora 

193 ora 


D 1 0 A : A9 D 1 
D 1 0C : 48 
D10D:BD F5 D1 
D1 10:48 
D 1 1 1 : 60 

D1 12:28 
D 1 1 3 : FA 

D 1 1 4 : B0 05 D11B 
D 1 16 : 9E B8 04 
D 1 19:80 C3 D0DE 


198 cmfound Ida 

199 pha 

200 Ida 

201 pha 

202 r t s 


; copy x to acc for arithmetic 
ielear carry for arithmetic 
;multiply index by 2 
;add 3 to get mask index 
;put mask index in X 
;get carry back 

;carry set ■ Enable so X is ready 
;cmd was Disable so inc X to next 
mask 

;go do mask stuff to FLAGS 

;sermode bit 0 tells whether to set 
or clear cmd mode 
> so get it 

;shift bit 0 to carry 

;if set, start new cmd mode 

;Restore the cursor 

{* fall through to cmset with carry 


;set command mode according to carry 

; leaves carry clear 
;character handled 
{because carry clear... 

;come here to handle LE $ LD 

;make LE look like L 

;get P back with carry indicating E 


;copy index of cmd to acc 
{restore X to Cn 
; copy top 2 bits of sermode 
;4 set bit 3 - 2-chr -command-mode 
flag 

{sermode now holds index to 2-chr 
command issued 

;set carry so we stay in command 
mode 

;for next time 

;get hi byte of where to go 

;save it on stack 

;get lo byte of where to go 

{save it on stack 

{ go there by RTSing 

{restore status to check carry bit 

{restore slot number in x 

{skip if enable 

;CD is same as PWDTH-0, no CR 

{we're done here 


D11B.-BC 86 D 1 
D 1 1 E : 20 2A D2 
D121 :9D B8 04 


D 1 24 : 80 B8 D0DE 


210 

211 

212 

213 


cmd. 


ldy 

sta 

bra 


def idx2-$C1 ,x 
r . getal t 
pwdth , x 
cdone 


get y index into aux screenholes 
go get it from aux 
restore default PWDTH 
we're done here 
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D18E : 0A 



281 


as 1 

A 

{Save it in C 

D126: FA 



215 

cmdz 

plx 


;Zero escape character 


D 1 8F : 20 

97 

C7 

282 


jsr 

swsthk2 

{assume video firmware active 

D127 : 9E 

B8 

04 

216 


stz 

pwdth , x 

; And the width 


D 1 92 : 90 

03 

D 1 97 

283 


bcc 

cmdq 

{branch if good guesser... 

D12A:A9 

00 


217 


Ida 

#0 



D 1 94 : 20 

9D 

C7 

284 


jsr 

swzzqt2 

{Reset the hooks 

D12C : 4C 

A2 

D0 

218 


jmp 

cmdz2 



D197: 18 



285 

cmdq 

clc 


{Quit terminal mode 










D198 : B0 



286 


dfb 

*B0 

{BCS to skip next byte 










D199: 38 



287 

cmdt 

sec 


{Into terminal mode 

D12F: 


D12F 

220 

cmdcr 

equ 

• 



D 19A : FA 



288 


plx 


{Recover X 

D12F: 


D12F 

221 

cmdn 

equ 

• 



D 1 9B : 20 

A0 

D 1 

289 


jsr 

set term 


D12F: 7A 



222 


ply 




D 1 9E : 80 

A8 

D 1 48 

290 


bra 

cdone2 


D 1 30 : AD 

7E 

04 

223 


Ida 

number 

;Get number Inputted 










D133 : F0 

05 

D13A 

224 


beq 

cmdl2 

I s k 1 p if 0 










D 1 35 : 99 

B8 

04 

225 


5 ta 

pwdth, y 

;Update printer width 


D1A0 : 


D1A0 

292 

set term 

equ 

* 

{set/clear terminal mode 

D 1 38 : F 0 



226 


dfb 

*F0 

;BEQ opcode to skip next byte 

(the 

D 1 A0 : BD 

B8 

03 

293 


Ida 

sermode , x 

{Get terminal mode status 








PLY) 


D 1 A3 : 89 

40 


294 


bit 

**40 

{Z”1 if not in terminal mode 

D139: 


D 1 39 

227 

cmdi 

equ 

• 



D 1 AS : 90 

12 

D1B9 

295 


bcc 

stclr 

{Branch if clearing terminal mode 

D 1 39 : 


D 1 39 

228 

cmdk 

equ 

• 



D 1 A7 : D0 

20 

D1C9 

296 


bne 

s twasok 

{Mas already set 

D 1 39 : 


D 1 39 

229 

cmd 1 

equ 

• 



D 1 A9 : E4 

39 


297 


cpx 

k swh 

{Are we in the input hooks 

D139: 7A 



230 


ply 




D 1 AB : D0 

47 

D1F4 

298 


bne 

strts 

{Leaves C-1 if - 

D13A:B9 

B8 

06 

231 

cmd 1 2 

Ida 

flags , y 



D 1 AD : 09 

40 


299 


ora 

**40 

{Set term mode bit 

D 1 3D : 3D 

02 

D2 

232 


and 

mask 1 , x 

;Mask off bit we'll change 


DIAFsAC 

79 

06 

300 


ldy 

oldcur 

{Save what was in oldcur 

D140 : ID 

0D 

D2 

233 


ora 

mask2 , x 

{Change it 


D 1 B2 : 8C 

7A 

06 

301 


sty 

o 1 dcur 2 


D 1 43 : 99 

B8 

06 

234 


s ta 

flags , y 

;Back it goes 


D 1 B5 : A0 

DF 


302 


ldy 

* termeur 

{Get new cursor value 

D 1 46 : 98 



235 


tya 


{Put slot back in x 


D 1 B7 : 80 

07 

D1C0 

303 


bra 

stset 


D 1 4 7 : AA 



236 


tax 


{(via acc) 


D 1 B9 : F 0 

0E 

D1C9 

304 

stclr 

beq 

5 twasok 

{Branch if already clear 

D 1 48 : 4C 

DE 

D0 

237 

cdone2 

jmp 

cdone 

{Good bye 


D IBB: 29 

BF 


305 


and 

* *BF 

{Clear the bit 










D 1BD : AC 

7A 

06 

306 


ldy 

o ldcur 2 

{Restore the cursor 










D 1 C 0 : 9D 

B8 

03 

307 

stset 

sta 

sermode , x 


D 1 4B : 88 



239 

cmdp 

dey 


{Make y point to command reg 


D 1 C3 : 8C 

79 

06 

308 


sty 

oldcur 

{Save cursor to be restored after 

D 1 4 C : A9 

IF 


240 

cmdd 

Ida 

* $ 1 F 

{Mask off high three bits 









command 

D 1 4E : 38 



241 


sec 


;C»1 means high 3 bits 


D 1 C6 : 8C 

FB 

07 

309 


sty 

cursor 


D 1 4F : 90 



242 


dfb 

*90 

; BCC opcode to skip next byte 


D1C9:BC 

42 

Cl 

310 

stwasok 

ldy 

devno2 , x 


D1 50 : A9 

F 0 


243 

cmdb 

1 da 

**F0 

{Mask off lower 4 bits F0 - BNE 

D1CC :S8 



311 


c 1 i 


{want to leave with interrupts 

D 1 52 : 18 



244 


c lc 


;F0 will skip this if cmdp or 

cmdd 








active 

D 1 53 : 39 

FB 

BF 

245 


and 

sent 1 ,y 

{Mask off bits being changed 


D 1 CD : 08 



312 


php 



D 1 56 : 8D 

F8 

06 

246 


s ta 

temp 

{Save it 


D 1 CE : 78 



313 


sei 


{but off while we twlttle bits 

D 1 59 : FA 



247 


plx 




D 1 CF : B9 

FA 

BF 

314 


Ida 

scomd , y 


D15A: AD 

7E 

04 

248 


1 da 

number 

{Get inputed number 


D 1 D2 : 09 

02 


315 


ora 

**2 

{disable receiver interrupts if 

D 1 5D : 29 

0F 


249 


and 

**0F 

{Only lower nibble valid 


D 1 D4 : 90 

02 

D1D8 

316 


bcc 

cmd t 2 

{ not in terminal mode 

D 1 5F : 90 

05 

D 166 

250 


bcc 

noshl f t 

;If C"1 shift to upper 3 bits 


D 1 D6 : 29 

FD 


317 


and 

**FD 

{enable when in terminal mode 

D 1 6 1 : 0 A 



251 


as 1 

A 



D1D8: 


D1D8 

318 

cmdt 2 

equ 

* 


D 162 : 0 A 



252 


as 1 

A 



D 1 D8 : 99 

FA 

BF 

319 


sta 

scomd , y 


D163 : 0A 



253 


as 1 

A 



D 1 DB : A9 

00 


320 


Ida 

*0 


D164 : 0A 



254 


as 1 

A 



D1DD:6A 



321 


ror 

a 

{set kbd interrupts according to 

D 165 : 0A 



255 


as 1 

A 










t-mode 

D 166 : 0D 

F8 

06 

256 

nosh 1 f t 

ora 

temp 

{Get the rest of the bits 


D IDE : 8D 

FA 

05 

322 


sta 

typhed 


D169: C8 



257 


1 ny 


{Put them in the ACIA 


D1E1 : 10 

07 

D1EA 

323 


bpl 

cmd t3 

{branch if leaving terminal mode 

D16A : 80 

17 

D183 

258 


bra 

cmdp2 

{increment puts em away where 

they 

D 1 E3 : 9C 

7F 

05 

324 


stz 

twser 

{ and ser buf . . . 








go. 


D 1 E6 : 9C 

7F 

06 

325 


stz 

trser 











D 1 E9 : 8A 



326 


txa 


{use x to enable serial buffering 










D1EA:8D 

FF 

04 

327 

cmdt3 

sta 

ac labuf 


D16C:B9 

FA 

BF 

260 

cmds 

1 da 

scomd , y 

{Transmit a break 


D 1 ED : 28 



328 


pip 


{restore carry, enable interrupts 

D 16F : 48 



261 


pha 


{Save current ACIA state 


D1EE :8E 

FF 

05 

329 

f lush 

stx 

twkey 

{Flush the type ahead buffer 

D 1 70 : 09 

0C 


262 


ora 

**0C 

;Do the break 


D1F1 :8E 

FF 

06 

330 


5 t X 

tr key 


D 172: 99 

FA 

BF 

263 


s ta 

scomd , y 



D 1 F4 : 60 



331 

strts 

rts 



D 1 75 : A9 

E9 


264 


1 da 

*233 

{For 233 ms 










D 1 77 : A2 

53 


265 

mswal t 

1 dx 

*83 

;Mait 1 ms 


D1F5 : 



333 


MSB 

OFF 


D 1 79 ; 48 



266 

ms loop 

pha 


;CC12*82)*11)*2*3«1000us 


D1F5: 


D1F5 

334 

cmdtable 

equ 

• 

{command routines' lo bytes 

D 1 7A : 68 



267 


pla 




D 1 F5 : 38 



335 


dfb 

> cmd i - 1 


D 1 7B : C A 



268 


dex 




D 1 F6 : 38 



336 


dfb 

>cmdk - 1 


D17C:D0 

FB 

D 1 79 

269 


bne 

msloop 



D 1 F7 : 38 



337 


dfb 

>cmdl - 1 


D 1 7E : 3A 



270 


dec 

a 



D 1 F8 : 2E 



338 


dfb 

>cmdn- 1 


D 1 7F : D0 

F6 

D177 

271 


bne 

mswal t 



D 1 F9 : 2E 



339 


dfb 

>cmdcr- 1 


D 18 1 : 68 



272 


pla 




D1 FA : 4F 



340 


dfb 

> cmdb- 1 


D 1 82 : F A 



273 


plx 




D1FB: 4B 



341 


dfb 

>cmdd- 1 


D 1 83 : 


D 1 83 

274 

cmdp2 

equ 

• 



D 1 FC : 4A 



342 


dfb 

>cmdp- 1 


D 1 83 : 99 

FA 

BF 

275 


s ta 

scomd , y 



D 1 FD : 96 



343 


dfb 

> cmdq- 1 


D 1 86 : 80 

C0 

D 1 48 

276 


bra 

cdone2 



D 1 FE : 87 



344 


dfb 

>cmdr - 1 











D 1 FF : 6B 



345 


dfb 

>cmds- 1 











D200 : 98 



346 


dfb 

>cmdt - 1 


D188: 


D 1 88 

278 

cmdr 

equ 

• 



D20 1 : 25 



347 


dfb 

>cmdz - 1 


D 188 : 99 

F9 

BF 

279 


sta 

sstat ,y 

{Reset the ACIA 










D18B: AD 

7B 

06 

280 


Ida 

vf ac tv 

;Check if video firmware active 

D202: 



349 

• masks 

for : 

I K L 

N CR XE XD FE FD ME MD 










D202 : 7F 

BF 

BF 7F 

350 

mask 1 

dfb 

*7F , *BF , *BF 

,*7F,*FF,*DF,*DF,*EF,*EF,*F7,*F7 
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D247 : 03 07 379 defidx2 dfb 3,7 ;same as DEFIDX in main rom. 

D249: 59 Include mbasic ;Mouse BASIC routines 0 2:C100 


27 MBASIC 


Mouse BASIC routines 
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D249: 01B7 2 ds «D400-»,0 



27 MBASIC Mouse BASIC routines 26-JUL-8S PAGE 101 


D400 




4 






D400 




5 






D400 




6 


BAS1CIN 

- Input from basic 


D400 




7 






D400 




8 


Creates 

♦XXXXX, ♦YYYYY.+SS 


D4 0 0 




9 


XXXXX 

X po 

5 i t i on 


D400 




10 


YYYYY 

Y position 


D400 




1 1 


SS ■ Status 



D400 




12 


- 

- Key 

pressed 


D400 




13 


1 

- Button pressed 


D400 




14 


2 

- Button Just pressed 

D400 




15 


3 

- Button just released 

D400 




16 


4 

* Button not pressed 


D400 




17 






D400 




18 






D400 



D400 

19 

bas i c i n 

equ 

• 


D400 

91 

28 


20 



5 ta 

( bas 1 > , y 

;Fix flashing char 

D402 

A9 

05 


21 



1 da 

#> i nent 

{Fix input entry 

D404 

85 

38 


22 



s ta 

kswl 


D406 

AD 

00 

C0 

23 



1 da 

kbd 

; tes t the keyboard 

D409 

0 A 



24 



as 1 

A 


D40A 

08 



25 



php 


;Save kbd and int stat for later 

D40B 

78 



26 



sei 


;No Interrupts while getting 










pos i t i on 

D40C 

20 

41 

D4 

27 



Jsr 

xmr ead2 


D40F 

A0 

05 


28 



1 dy 

'5 

{Move X position into the buffer 

D41 1 

AE 

7C 

05 

29 



1 dx 

mouxh 


D414 

AD 

7C 

04 

30 



1 da 

moux 1 


D417 

20 

SC 

D4 

31 



Jsr 

hextodec 

{Convert it 

D4 1 A 

A0 

0C 


32 



1 dy 

* 1 2 


D41C 

AE 

FC 

05 

33 



ldx 

mouyh 


D4 1F 

AD 

FC 

04 

34 



Ida 

mouy 1 


D422 

20 

5C 

D4 

35 



Jar 

hextodec 


D425 

AD 

7C 

07 

36 



1 da 

mous tat 


D428 

2A 



37 



rol 

A 


D429 

2A 



38 



r o 1 

A 


D42A 

2A 



39 



rol 

A 


D42B 

29 

03 


40 



and 

#3 


D42D 

49 

03 


41 



eor 

• 3 


D42F 

1 A 



42 



inc 

A 


D430 

28 



43 



pip 


{Restore int t kbd status 

D43 1 

A0 

10 


44 



1 dy 

#16 


D433 

20 

6D 

D4 

45 



Jsr 

hexdec2 

;X»0 from last div10 

D436 

7A 



46 



ply 



D437 

A2 

11 


47 



ldx 

#17 

; X - EOL 

D439 

A9 

8D 


48 



Ida 

#$8D 

{Carriage return 

D43B 

9D 

00 

02 

49 

pu t i nbuf 

s ta 

inbuf ,x 


D43E 

4C 

84 

C7 

50 



Jmp 

swr ts2 

; Gobac k 


D44 1 : 

D44 1 : 

D44 1 : 

D44 1 : 



52 

53 

54 

55 

• XMREAD2 

- dup 1 

lcate of 

xmr ead 

D44 1 : 



56 





D44 1 : 


D44 1 

57 

xmr ead2 

equ 

• 


D441 :A9 

20 


58 


1 da 

#movarm 

;Has mouse moved? 

D443 : 2D 

7C 

06 

59 


and 

mouarm 


D446: 1C 

7C 

06 

60 


t rb 

mouarm 

{Clear arm bit 

D449 : 2C 

63 

C0 

61 


bit 

moubu t 

{Button pressed? 

D44C : 30 

02 

D450 

62 


bmi 

xrbu t3 


D4 4E : 09 

80 


63 


ora 

#<80 


D450 : 2C 

7C 

07 

64 

xrbu t3 

bit 

moustat 

{Pressed last time? 

D453 : 10 

02 

D457 

65 


bp 1 

xr bu 1 4 


D455 : 09 

40 


66 


ora 

#$40 


D457 : 8D 

7C 

07 

67 

xrbu t4 

s ta 

moustat 


D45A: 18 



68 


c lc 



D45B : 60 
D45C : 



69 

70 


rts 




D45C: 71 * 

D45C: 72 # HEXTODEC - Puts *0000, into the input buffer 


CO 


27 MBASIC 

D45C: 

D45C : 

D45C : 

D45C : 

D45C : 

D45C : D45C 

D45C : E0 80 

D45E : 90 0D D46D 

0460:49 FF 

D462 : 69 00 

D464 : 48 

D465 : 8A 

D466 : 49 FF 

D468 : 69 00 

D46A : AA 

D46B : 68 

D46C : 38 

D46D : 8D 14 02 

D470 : 8E IS 02 

D473 : A9 2B 

D475 : 90 02 D479 

D477 : A9 2D 

D479 : 48 

D47A : A9 2C 

D47C : 99 01 02 

D47F : D47F 

D47F : 

D47F : 

D47F : 

D47F : A2 11 

D48 1 : A9 00 

D483: 18 

D484 : 2A 

D485 : C9 0A 

D487 : 90 02 D48B 

D489 : E9 0A 

D48B : 2E 14 02 

D48E : 2E 15 02 

D49 1 : C A 

D492 : D0 F0 D484 
D494 : 09 30 
D496 : 99 00 02 
D499 : 88 

D49A : F 0 08 D4A4 

D49C : C0 07 

D49E : F 0 04 D4A4 

D4A0 : C0 0E 

D4A2:D0 DB D47F 

D4A4 : 68 

D4A5 : 99 00 02 

D4 A8 : 60 

D4A9: 




4- 28 BANGER 


D4A9 

D4A9 

D4A9 


D4A9: 

D4A9: 

D4A9: 

D4A9: 

D4A9: 

D4A9 : 

D4A9 : 

D4A9 : 

D4A9 : 

D4A9 : 

D4A9 : 

D4A9: 

D4A9 : 

D4A9 : 

D4A9: 

D4A9 : 

D4A9 : 

D4A9 : 

D4A9 : 

D4A9 : 

D4A9 : 

D4A9 : 0011 

D4A9 : 0009 

D4A9: 0001 

D4A9: 05B8 

D4A9 : 

D4A9 : 8D 50 C0 
D4 AC : 8D 78 C0 
D4AF : 8D 5F C0 
D4B2 : 

D4B2 : 

D4B2 : 

D4B2 : A0 04 
D4B4 : A2 00 
D4B6 : 18 
D4B7 : 79 2A C8 
D4BA : 95 00 
D4BC : E8 


D4BD : D0 F7 D4B6 

D4BF: 18 

D4C0 : 79 2A C8 

D4C3 : D5 00 

D4CS : D0 10 D4D7 

D4C7 : E8 

D4C8 : D0 F5 D4BF 
D4CA : GA 

D4CB : 2C 19 C0 

D4CE : 1 0 02 D4D2 
D4D0 : 49 A5 
D4D2 : 88 

D4D3 : 1 0 El D4BG 
D4D5 : 30 06 D4DD 


D4D7 : 55 00 
D4D9 : 18 
D4DA.-4C 73 C4 
D4DD : 4C C6 C3 


D4E0 : D4E 0 

D4E0 : 20 90 C7 
D4E3 : 68 
D4E4 : 7A 
D4E5 : 68 


Apple //c Diagnostics 


These routines test all 128K ram. All combinations of soft 
swi tches 

applicable to the //c are tested and verified. 


mposed of "RAM ZP" (indicating 


In the event of any failure, the diagnostic is halted. A 
message 

is written to screen memory Indicating the source of the 
failure. 

When RAM fails the message is composed of "RAM ZP" (indicating 
fai lure 

detected in the first paqe of RAM) or "RAM" (meaninq the other 
63.75K), 

followed by a binary representation of the failing bits set to 

For example, "RAM 01100000" indicates that bits 5 and 6 
were 

detected as failing. To represent auxiliary memory, a "*" 
symbol is 

printed preceeding the message. 

When the MMU or I0U fail, the message is simply "MMU" or "IOU". 
If the I0UDIS or DHIRES switch fails, the message is "GLU". 

The test will run continuously for as long as the Open and 
Closed 

Apple keys remain depressed (or no keyboard is connected) and no 
failures are encountered. The message "System OK" will appear 


continuously for as long as the Open and 


either of the Apple keys are no longer depressed. Another cycle 
may be initiated by pressing both Apple keys again while this 
message 

is on the screen. To exit diagnostics. Control -Reset must be 
pressed 

without the Apple keys depressed. 


28 GLU I DX 

29 I DU I DX 

30 MMU I DX 

31 SCREEN 


EQU 111 
EQU $09 
EQU $01 
EQU $5B8 


33 DIAGS sta txtclr ;text mode off 

34 sta ioudsbl {Disable IOU 

35 sta setan3 {Double hires off 

36 • Test Zero-Page, then all of memory. Report errors when 

encountered . 

37 • Accumulator can be anything on entry. All registers used, but no 

stack . 

38 • Addresses between $C000 and $CFFF are mapped to main $D000 bank. 


{fill zero page with a pattern 


adc ntbl.y 
cmp $00, x 
bne ZPERROR 


{after all bytes filled, 

; ACC has original value again, 
{so values can be tested 

{branch if memory failed 

{loop until all 256 bytes tested 
{change ACC so location $FF will 
change 

; use RDVBL for a little 
randomness . . . 


use a different pattern now 
branch to retest with other value 
branch always 


{which bits are bad? 
{indicate zero page failure 


{Get out of the hooks 
{Get junk off of stack 


28 BANGER 


Apple //c Diagnostics 
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D4E6 : A9 FF 

D4E8 : AA 

D4E9 : E8 

D4EA : 5D F5 D4 

D4ED : 9D 00 02 

D4F0 : 10 F7 D4E9 

D4F2 : 4C 84 C7 

D4F5 : AD 3B 0A 0B 
D4FD: 00 05 08 0C 
D505 : 1C 07 0C 45 
D50D: 1C 07 07 05 
D515: 0E 45 61 32 
D5 1 D : 53 6A 2B 0C 
D525 : 3D 06 07 IB 
D52B : 


D52B: 

D52B : 

D52B : 

D52B: 2ACF 

FFF A : 88 C7 
FFFC : 88 C7 
FFFE : 8E C7 


71 Ida #$FF 

72 tax 

73 zzloop i nx 

74 eor qtbl , x 

75 sta inbuf.x 

76 bpl zzloop 

77 Jmp swrts2 

79 qtbl dfb $AD , $3B , $ 0A , $ 0B , $48 , $77 , $3E , $05 

80 dfb $00,$05,$08,$0C,$1E,$53,$65,$37 

81 dfb $1C,$07,$0C,$45,$62,$27,$00,$17 

82 dfb $1C,$07,$07,$0S,$4B, $6D, $24 , $02 

83 dfb $0E,$45,$61 ,$32,$18,$02,$07,$1D 

84 dfb $53,$6A,$2B,$0C,$08,$16,$53,$68 

85 dfb $3D,$06,$07,$1B,$01 ,$E3 

61 include vectors2 


2 

3 

4 

5 

6 

7 

8 


• VECTORS 


ds IFFFA-* , $00 
dw swreset2 

dw swreset2 

dw swirq2 


NMI 
RESET 
I NT 



29 SYMBOL TABLE 


SORTED BY SYMBOL 
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3D A1H 

FE7F A1PCRTS 
40 A3L 
44 ASL 

C24E ACIADONE 
FDD 1 ADD 
C24C AIAUX 
C20 A A I PASS 
C91D AMOD1 
C94A AMODS 
703F5 AMPERV 
CS80 ATALK 
C4B0 BADPRIM 
C7C 1 BANGER 
FBD0 BASCLC2 
E003 BASIC2 
28 BASL 
FA8S BEEPSKIP 
CS3F BIGLOOP 
FE 0 0 BL 1 
CS47 BLP3 
3C BOOTTMP 
03F0 BRKV 
?FC 1 0 BS 
C062 BUTN1 
C30S C3KEYIN 
7CD7D CGO 
0D CHARCR 
24 CH 

FF7A CHRSRCH 
FC46 CLEOP1 
CBF 1 CLR2 
CBDA CLR80 
7C05A CLRAN1 
C2A5 CLRCOL 
FC42 CLREOP 
CC99 CLRKBD 
F838 CLRSC2 
F83C CLRSC3 
D0FD CMD2F0UND 
7D068 CMD2NULL 
D14C CMDD 
D 1 39 CMDL 
D14B CMDP 
D16C CMDS 
DIFS CMDTABLE 
C 168 CMLOK 
C18E CMNOY 
D0EA CMSET 
0738 COL 
FCFB COM3 
7D0 1 1 COMMAND 1 
CF8C COMTBL 
FDF0 COOT 1 
7FD8B CROUT1 
36 CSWL 
FCA4 CTLDO 
14 CTLNUM 
07FB CURSOR 
Cl 24 CVMOVED 
C2B6 DEFAULT 
D247 DEFIDX2 
C22B DEVNO 
FF8A DIG 
CBC2 DOCLR 
C9F 4 DOLIN 
C566 DQUIT 
D0CS ENABLE 
C9C9 ERR2 
7CCE3 ESC 1 
0638 ESCHAR 


3C AIL 
3F A2H 
43 A4H 
45 ACC 

C1B4 AC I A I NT 
FD84 ADDINP 
C208 A I EAT I T 
C1DC AIP0RT2 
C93A AM0D2 
C94F AMOD6 
CSBB APPLE2C 
D08F BACKTOI 
C6A2 BADRD1 
2B BAS2H 
FEB3 BASCONT 
C324 BASICENT 
C47D BBITS1 
FF3A BELL 
0215 BINH 
FE04 BLANK 
C556 BLP4 
7C326 BPRINT 
C4CE BSWTCH1 
C4E7 BSWTCH3 
C38A C03 
FD62 CANCEL 
F9BA CHARI 
C234 CHARPTR 
C 1 36 CHKMOU 
FFCC CHRTBL 
C504 CLICK 
CC02 CLR3 
C000 CLR80COL 
7C05C CLRAN2 
FC9C CLREOL 
CBCF CLRHALF 
FCA0 CLRLIN 
7F832 CLRSCR 
F836 CLRTOP 
D225 CMD2LIST 
D 1 50 CMDB 
D 1 39 CMDI 
D218 CMDL I ST 
D 1 83 CMDP2 
D1D8 CMDT2 
D0A2 CMDZ2 
C14B CMLOOP 
C 1 70 CMNT0 
C 1 55 CMXMOV 
30 COLOR 
D0BF COM I N I T 
C24F COMMPORT 
C348 C0PYR0M2 
FDF6 COUTZ 
FD8E CROUT 
CD2A CTLADR 
CD6F CTLDONE 
CD9 1 CTLOFF 
Cl 18 CVNOVBL 
FDB6 DATAOUT 
C2DF DEFCOM 
C2BC DEFLOOP 
C 1 42 DEVH02 
D0C7 DISABLE 
FBB4 DOCOUT1 
C 1 86 DONE 
7C60B DRV2ENT 
C219 ENTR 
7C9CB ERR3 
CCE5 ESC2 
0013 ESCNUM 


FE78 A1PCLP 
3E A2L 
42 A4L 
C1B3 ACDONE 
C1BA ACIAINT2 
FBF8 ADV2 
C24D A I EAT 
C1D6 AITST2 
C93C AM0D3 
CA29 AM0D7 
FB60 APPLE I I 
C473 BADBITS 
C6D3 BADREAD 
2A BAS2L 
29 BASH 
D400 BASICIN 
C4BB BBITS2 
7FBDD BELLI 
0214 BINL 
FCD0 BLAST 
4F BOOTDEV 
CAF 1 BRANCH 
C4D8 BSWTCH2 
04 BUTMODE 
C307 C3C0UT1 
D0DE CDONE 
F9B4 CHAR2 
CDCD CHK80 
CB4E CHKRT 
D0A5 CKDIG 
CBEE CLR0 
CBC7 CLR40 
C00E CLRALTCHAR 
7C05E CLRAN3 
FC5D CLREOP 1 
CD9B CLRIT 
CC04 CLRPORT 
C48 1 CLRSTS 
D 1 1 B CMD.C1 
D087 CMD2L00P 
D12F CMDCR 
D13A CMDI 2 
D091 CMDLOOP 
D 1 97 CMDQ 
D1EA CMDT3 
D 1 26 CMDZ 
C18A CMNOINT 
Cl 75 CMRGHT 
C37F COI 
FCE6 COM 1 
D0B5 COMINIT1 
C24C COMOUT 
C338 COPYROM 
FEF6 CRMON 
FC8S CRRTS 
CD54 CTLCHAR0 
CD7 1 CTLGO 
CD95 CTLON 
25 CV 
FBBC DCX 
C2C7 DEFFF 
C6D9 DENIB1 
D4A9 DIAGS 
7C983 DISLIN 
FB54 DOCTL 
FD20 DONXTCUR 
D484 DV10LOOP 
C111 ENTR 1 
9B ESC 
CCC0 ESC3 
CCED ESCRDKEY 


FE75 A 1 PC 
4 1 A3H 
45 A5H 

04FF ACIABUF 
C1C2 ACIATST 
7FBF4 ADVANCE 
C200 A I NOFLSH 
C01E ALTCHARSET 
C93B AM0D4 
CA38 AM0D8 
0438 ASTAT 
C4A9 BADMAIN 
C4CA BADSWTCH 
FBC 1 BASCALC 
E000 BASIC 
C317 BASICINIT 
FD7 1 BCKSPC 
FBE4 BELL2 
C329 BINPUT 
7CS43 BLP2 
C5F5 BOOTFAIL 
7FA4C BREAK 
C4E4 BSWTCH2A 
C06 1 BUTN0 
7C300 C3ENTRY 
D 1 48 CD0NE2 
05FE CHARBUF 
FBD9 CHKBELL 
C 1 30 CHOK 
FC9E CLEOLZ 
CBF C CLR1 
C00C CLR80VID 
7C058 CLRAN0 
FEE9 CLRCH 
FC44 CLRE0P2 
CFBD CLRKBD2 
7CFFF CLRROM 
C49 1 CLRS 
D112 CMD.C 
D0F4 CMD2L 
BF CMDCUR 
D 1 39 CMDK 
D12F CMDN 
D188 CMDR 
D199 CMDT 
D 1 0 A CMFOUND 
C 1 A 1 CMNOVBL 
C 162 CMROK 
FCCA COLDSTART 
FCF5 COM2 
D000 COMMAND 
C200 COMSLOT 
FDED COUT 
FC62 CR 
37 CSWH 
CD58 CTLCHAR 
CD80 CTLGO 1 
CD 1 5 CTLTAB 
C12B CVBUT 
FEE2 DECCH 
C2EA DEFIDX 
C6D7 DEN I BL 
D0AD DIGLOOP 
0356 DNIBL 
C9D8 DO INST 
FECE DOPR0 
D48B DV10LT 
F8A 1 ERR 
CCD7 ESC0 
CD0C ESCCHAR 
CCF8 ESCTAB 
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C275 EXIT1 
0538 EXTINT 
C 1 40 FIXCH 
06B8 FLAGS 
CD67 FNDCTL 
27 GBASH 
C32 1 GBDONE 
C346 GDEAT 
C393 GETALT1 
C2F7 GETBUF 
CCB7 GETCUR3 
F8A5 GETFMT 
C816 GETLC 
FFA7 GETNUM 
C2B2 GETSTAT2 
CF38 GKEY 
C5EE GOBASICIN 
CB0D GODSP 
C278 GOREMOTE 
7FD25 GOTKEY 
2C H2 

D47F HDLOOP 
D45C HEXTODEC 
FC58 HOME 
F897 IEVEN 
0200 IN 
FF 1 5 INDX 
7FE8B INPORT 
F8D0 INSTDSP 
C 0 0 0 IOADR 
C078 IOUDSBL 
C82A IRQ21 
C848 I RQ5 
C88C IRQDN1 
C8A4 IRQDN5 
FFFE IRQVECT 
C663 ISMRK1 
C335 JPSTAT 
FB88 KBDWAIT 
38 KSWL 
C08B LCBANK1 
FC66 LF 
2C LMNEM 
FD38 LOOKPICK 
7 40 M . 4 0 

08 M.GOXY 
44 MACSTAT 
2E MASK 
067D MAX XL 
C5EA MBBAD 
C3F5 MEM4 
C42A MEM8 
C44F MEMC 
0578 MINH 
057D MINXH 
CF A3 MIRQLP 
0001 MMUIDX 
F8C2 MNNDX2 
FF69 MONZ 
C048 MOUCLR 
C100 MOUSEINT 
0478 MOUTEMP 
047C MOUXL 
0 4FC MOUYL 
C36 1 M0VEC2M 
C393 MOVERET 
C900 MPADDLE 
CAFF NBRNCH 
FA47 NEWBRK 
FC73 NEWCR 
FC38 NEWOP1 


C273 EXITX 
0SF9 EXTINT2 
C80E FIXLC 
7D1EE FLUSH 

2E FORMAT 

26 GBASL 
C8C 1 GBNOC 
C334 GDNOLF 
C398 GETALT2 
C3A6 GETCOUT 
CCBF GETCURX 
C9E7 GETI1 
7FD6F GETLN1 
C98F GETOP 
C5B4 GETUP 
C826 GLCBNK1 
C8A7 GOBREAK 
C9EC G0ERR2 
FEB6 GO 
F8CC GOTONE 
C4C8 HANGX 
D479 HDP0S2 
7C057 HIRES 
CDAS HOMECUR 
0200 INBUF 
D032 INCMD2 
C405 INENT 
FE8D INPRT 
CC12 INVERT 
FEDE IOPRT1 
C079 IOUENBL 
C826 I RQ2 
C8SB I RQ6 
C88E IRQDN2 
C87F IRQDONE 
7FA40 IRQ 
C3C3 JMPDEST 
C332 JPWRITE 
FD1B KEYIN 
CFDB LACR 
C083 LCBANK2 
0400 LINE1 

00 LOC0 
C056 LORES 

20 M.CTL2 

01 M. MOUSE 
C58E MAKTBL 
05F8 MAXH 

707FD MAX YH 
C3D0 MEM1 
C3F A MEM5 
C42C MEM9 
C456 MEMD 
C9C7 M I N I ERR 
047D MINXL 
CFBA MIROSTD 
F9C0 MNEML 
F8C9 MNNDX3 
FF65 MON 
7C058 MOUDSBL 
CD9F MOUSOFF 
C066 MOUX1 
C067 MOUY1 
C972 MOV 1 
CF9A MOVE IRQ 
C367 MOVESTRT 
D 1 79 MSLOOP 
0300 NBUF1 
FC99 NEUIC1 
CCCC NEWESC 
FC35 NEWOPS 


C63D EXTENT 1 
F800 F80RG 
7FA9B FIXSEV 
F962 FMT 1 
7C648 FUGIT 
C8C9 GBBRK 
C30D GBNOOVR 
C340 GDNXON 
C37C GETALT 
CCA7 GETCUR1 
CC9D GETCUR 
FC80 GETINDX 
FD67 GETLNZ 
C2AC GETSTAT 
CEFA GETX 
C829 GLCDONE 
CB25 GODDONE 
C96E GOERR 
C19B G0SER3 
C2C1 GSTNO I NT 
C4ED HANGY 
7FCC9 HEADR 
7F819 HLINE 
CE IB HOOKITUP 
D084 INCMD1 
D022 INCMD 
C4 1 A INI TMOUSE 
F882 INSDS1 
32 INVFLG 
FEAB I0PRT2 
0009 IOUIDX 
C834 I RQ3 
C85E I RQ7 
C896 IRQDN3 
C804 IRQENT 
C882 IRQLCOK 
C32C JPINIT 
C010 KBDSTRB 
7FD18 KEY I N0 
CFD8 LADIG 
2F LENGTH 
FE63 LIST2 
01 LOCI 
FE20 LT 
08 M.CTL 
80 M. PASCAL 
D202 MASK 1 
04F8 MAXL 
706FD MAXYL 
C3D8 MEM2 
C405 MEM6 
C43 1 MEMA 
C472 MEMERROR 
FE6C MINI 
705FD MINYH 
7C052 MIXCLR 
FA00 MNEMR 
FDAD M0D8CHK 
067C MOUARM 
7C059 MOUENBL 
CD99 MOUSON 
057C MOUXH 
05FC MOUYH 
20 MOVARM 
C367 MOVELOOP 
C970 MOVINST 
07F8 MSLOT 
FBB0 NEUIADV1 
FC90 NEWCLEOLZ 
C803 NEW I RQ 
CADI NEWPCL 


7C6SC EXTENT 
FBB3 F8VERS I ON 
D077 FLAGIT 
F9A6 FMT2 
F847 GBASCALC 
F856 GBCALC 
C8C7 GBNOTROM 
C348 GDOK 
C2FD GETBUF2 
CCAD GETCUR2 
C322 GETDATA 
C986 GET I NST 1 
7FD6A GETLN 
CBS7 GETST 
7CF06 GETY 
0011 GLUIDX 
CB22 GODREG 
06 G00DF8 
C279 GOTERM 
C2B4 GSTTST 
D4A4 HDDONE 
D46D HEXDEC2 
F81C HLINE1 
CE20 HOOKUP 
CB05 INITBL 
D03C INCMD3 
FB2F INIT 
F88E INSDS2 
CC 1C I NVX 
FE9B IOPRT 
C058 IOU 
C83E IRQ4 
C870 I RQ8 
C89C IRQDN4 
703FE IRQLOC 
CF86 IRQTBLE 
C32F JPREAD 
C000 KBD 
39 KSWH 
CFDE LADONE 
8A LFEED 
FE5E LIST 
CFC5 LOOKASC 
FE22 LT2 

10 M. CURSOR 
04 M.VMODE 
D20D MASK2 
077D MAXXH 
C400 MBASIC 
C3F3 MEM3 
C412 MEM7 
C440 MEMB 
C46C MEMF 
0478 MI NL 
704FD MINYL 
C053 MIXSET 
F8BE MNNDX1 
31 MODE 
C063 MOUBUT 
07FC MOUMODE 
077C MOUSTAT 
C015 MOUXINT 
C017 MOUYINT 
C34E MOVEAUX 
FE2C MOVE 
02 MOVMODE 
D177 MSWAIT 
FBA0 NEWADV 
FC8D NEWCLREOL 
7FA81 NEWMON 
FC86 NEWVTAB 
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CD 

FC88 NEWVTABZ 
0020 N0CMD2 
7FD4S N0ESC1 
C5AA NOPATRN 
C36A NOT 1 
CCS3 NOT I NV 
FB94 NOWAIT 
FCBA NXTA1 
FFA2 NXTBS2 
7F85F NXTCOL 
C9BD NXTOP 
067A 0LDCUR2 
FEFE OPTBL 
7FE95 OUTPORT 
C1A8 P 1 READ 
C ICE P1STRD 
C213 P2READ 
CF7 1 PASCALC 
C850 PASSK I P 1 
F954 PCADJ2 
CAB4 PCINC2 
C880 PCNV 
CC3D P I CK 1 
CC ID PICKY 
F800 PLOT 
FD92 PRA 1 
F92A PRADR4 
F948 PRBLNK 
7FF2D PRERR 
F8F5 PRMN1 
F8DB PRNTBL 
F940 PRNTYX 
CF54 PSETUP2 
CEBE PSTERR 
CE3B PVMODE 
03F4 PWREDUP 
FBI 2 PWRUP2 
CE44 QX 
7C060 RD40SW 
C016 RDALTZP 
CGBC RDAT3 
7FD35 RDCHAR 
C667 RDHD2 
C011 RDLCBNK2 
C01C RDPAGE2 
C687 RDSEC2 
C0 1 A RDTEXT 
FEBF REGZ 
C96B REL2 
FF3F RESTORE 
FADA RGDSP1 
4F RNDH 
C37B ROMOK 
F80C RTMASK 
7CAD5 RTNJMP 
FB2E RTS2D 
7FC34 RTS4 
7FF4C SAV1 
CE58 SCR 1 
CE82 SCRS 
CEAD SCR9 
CBA2 SCRLFT 
7F871 SCRN 
7FC70 SCROLL 
CG1F SEEKZERO 
C24F SER0UT3 
Cl 17 SERPORT 
CDC0 SET40 
C00F SETALTCHAR 
7C05D SETAN2 
FEEC SETCUR 
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C37 1 NEXTA1 
D01F NOCMD 
FD4A N0ESC2 
C37 1 NOREAD 
C1B2 NOTACIA 
7CCG8 N0TINV1 
C82A NTBL 
FCB4 NXTA4 
C9F8 NXTCH 
077B NXTCUR 
FA59 OLDBRK 
7FF59 OLDRST 
057B OURCH 
FE97 OUTPRT 
C1AF P1READ2 
C ICC P1STWR 
C217 P2STATUS 
7CF7F PASCLC2 
C23D PBFULL 
F9S6 PCADJ3 
CAB6 PCINC3 
CF 19 PCTL 
CC33 PICK2 
95 PICK 
F80E PLOT 1 
F910 PRADR1 
F930 PRADRS 
FDDA PRBYTE 
CEF7 PRET 
F8F9 PRMN2 
C 1 4 A PRNT 
33 PROMPT 
CF5 1 PSETUP 
7C070 PTRIG 
0 4B8 PWDTH 
CEF 4 PWRET 
FAA6 PWRUP 
D24 1 R.GETALT1 
C018 RD80COL 
C6A8 RDAT0 
CGCB RDAT4 
CG42 RDDHDR 
C67 1 RDHD3 
C012 RDLCRAM 
C013 RDRAMRD 
C68F RDSEC3 
C019 RDVBLBAR 
C96 1 REL 1 
FABD RESET. X 
7FF44 RESTR1 
FB02 RGDSP2 
4E RNDL 
0478 ROMSTATE 
F87F RTMSKZ 
2C RTNL 
F9G 1 RTS2 
7FDC5 RTS4C 
FF4A SAVE 
CESE SCR2 
CE8B SCR6 
05B8 SCREEN 
CB6D SCRLIN 
CE80 SCRN48 
CB38 SCROLLIT 
C27F SERIN 
C18A SEROUT 
C 1 89 SERRTS 
C001 SET80COL 
C009 SETALTZP 
C05F SETAN3 
FEEE SETCUR 1 


03FB NMI 
C469 NOERROR 
FD44 NOESCAPE 
D1G6 NOSHIFT 
FDSF N0TCR1 
CCGB NOT I NV2 
047E NUMBER 
FF98 NXTBAS 
FD75 NXTCHAR 
FF73 NXTITM 
047B OLDCH 
D07F ONELETTER 
0SFB OURCV 
C1DS P1ERR 
C9AD P1SKIP 
C1B4 P1WRITE 
C215 P2WRITE 
CC0B PASINVERT 
C235 PBOK 
F95C PCADJ4 
3A PCL 
C918 PDOK 
CC3F PICK3 
CF4 1 PINIT 
CEC0 PNOTRDY 
F914 PRADR2 
F94A PRBL2 
7FB1E PREAD 
7FDE3 PRHEX 
C 1 66 PRNOM 
F8D4 PRNTOP 
FD96 PRYX2 
CF30 PSETX 
C228 PUTBUF 
CEDD PWR 1 
CEC2 PWR I TE 
D4F5 QTBL 
D246 R.GETALT2 
C01F RD80VID 
C6AA RDAT1 
C6A6 RDATA 
C6S6 RDHD0 
7C01D RDHIRES 
C002 RDMAINRAM 
C014 RDRAMWRT 
C683 RDSECT 
7FEFD READ 
7F938 RELADR 
C354 RESETLC 
C64 1 RETRY 1 
C866 RMESS 
C028 ROMBANK 
C853 RSWTBL 
2D RTNH 
F83 1 RTS 1 
FBFC RTS3 
FE 1 7 RTS5 
BFFB SCNTL 
CE66 SCR3 
CE96 SCR7 
CBB9 SCRL3 
CBB0 SCRLODD 
CE53 SCRN84 
CB35 SCROLLUP 
C11C SERISOUT 
C18F SER0UT2 
C100 SERSLOT 
C00D SET80VID 
7C059 SETAN0 
C 1 82 SETCH 
CB67 SETDBAS 


CA3B NNBL 
C254 NOESC 
FAA3 NOFIX 
C4E6 N0STAT2 
FD4D NOTCR 
FEA7 NOTPRT0 
0016 NUMOPS 
FF90 NXTBIT 
FFAD NXTCHR 
CA06 NXTMN 
0679 OLDCUR 
FEC2 OPRT0 
C407 OUTENT 
C19E P1INIT 
C IBB P 1 STATUS 
C211 P2INIT 
C0G4 PADDL0 
CF35 PASREAD 
F9S3 PCADJ 
3B PCH 

C5F8 PCNVRST 
C90D PDON 
CC4A PICK4 
CEBC PIORDY 
C402 PNULL 
F926 PRADR3 
7F94C PRBL3 
FB25 PREAD2 
FDES PRHEXZ 
7F941 PRNTAX 
7F944 PRNTX 
CF66 PS 1 
CEB1 PSTATUS 
7D43B PUT I NBUF 
FAFD PWRCON 
CEF 1 PWR I TERET 
CE45 QUIT 
D22A R.GETALT 
C63F RDADR 
C6BA RDAT2 
C003 RDCARDRAM 
C65E RDHD1 
FD0C RDKEY 
7C01B RDM I X 
C685 RDSEC1 
FAE4 RDSP1 
FAD7 REGDSP 
C955 REL 
FA62 RESET 
C657 RETRY 
2D RMNEM 
C08 1 ROMIN 
CF94 RTBL 
CAD9 RTNJMP2 
FBEF RTS2B 
FCC8 RTS4B 
7FCB3 RTS6 
BFFA SCOMD 
CE79 SCR4 
7CE8D SCR8 
CB9B SCRLEVEN 
F879 SCRN2 
CB30 SCROLLDN 
BFF8 SDATA 
03B8 SERMODE 
C255 SER0UT4 
C 1 44 SERVID 
CDBE SET80 
7C0SB SETAN1 
7F864 SETCOL 
7FB40 SETGR 
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CE23 

SETHOOKS 

FE86 SETIFLG 

FES0 

SET I NV 

CDA 1 

SETIT 

FE89 SETKBD 

FE ID 

SETMDZ 

FE84 

SETNORM 

7FAA9 SETPG3 

FAAB 

SETPLP 

C360 

SETROM 

CB88 SETSRC 

C008 

SETSTDZP 

7FB39 

SETTXT 

CB83 SETUP2 

C21C 

SETUP 

C82A 

SETV 

FB4B SETWND 

CE 1 A 

SETX 

CC4C 

SHOWCUR 

C5C4 SHOWINST 

C28E 

SI DATA 

C463 

SINOCH 

C280 SINOKBD 

C2AC 

SINOMOD 

CBA8 

SKPLFT 

CBB4 SKPRT 

2B 

SLOTZ 

C86C 

SMESS 

C46A SMINVALID 

C2AA 

SODONE 

C28D 

SOOK 

C25E SORDY 

C2AB 

SORTS 

C207 

SOUT 

C030 SPKR 

49 

SPNT 

CF29 

STARTXY 

48 STATUS 

D1B9 

STCLR 

FE7 1 

STEPZ 

FB65 STITLE 

FBF0 

STORADV 

C3DB 

STORE 1 

C3EE ST0RE2 

7C3F2 

ST0RE3 

C3F9 

ST0RE5 

7FE0B STOR 

7C3F7 

ST0RE4 

D1F4 

STRTS 

D1C0 STSET 

D1C9 

STWASOK 

C56B 

SUC2 

C875 SUCCESS 

C22F 

SUDODEF 

C232 

SUNODEF 

C24 0 SUOUT 

7C7C7 

SWATALK 

C79D 

SWBASICIN 

C4EF SWCHTST 

C7A9 

SWCMD 

C537 

SWERR 

C7DF SWGETB 

C7D3 

SWGETST 

C7BB 

SWMINT 

7C797 SWPCNV 

C7D9 

SWREAD 

C788 

SWRESET2 

C780 SWRTI 

7C780 

SWRTI2 

C784 

SWRTS2 

C787 SWRTSOP 

C7CD 

SWSER3 

C7F 1 

SWSTHK3 

C7A3 SWSTTM 

C7F 1 

SWSTTM3 

C84 1 

SWTBL1 

C4F 1 SWTST1 

C4F3 

SWTST2 

C508 

SWTST4 

C5 1 A SWTST5 

C52 1 

SWTST6 

C7B5 

SWXFER 

7C7EB SWXFGO 

C7EB 

SWXFG02 

C79D 

SWZZQT2 

C7F6 SWZZQT3 

C15E 

TAB 

C592 

TBLLOOP 

C5A0 TBLLOOP2 

0578 

TEMPA 

04F8 

TEMPI 

05F8 TEMPY 

C27C 

TERM1 

C25E 

TESTKBD 

0800 THBUF 

7FB09 

TITLE 

FFBE 

TOSUB 

FE6F TRACE 

06FF 

TRKEY 

C3C6 

TSTMEM 

D4DD TSTMEM2 

D4B2 

TSTZPG 

057F 

TWSER 

C0S0 TXTCLR 

C054 

TXTPAGE 1 

C05 1 

TXTSET 

05FA TYPHED 

00 

UCSPACE 

CC70 

UPDATE 

C399 UPSHIFT0 

C39B 

UPSHIFT 

FECA 

USR 

03F8 USRADR 

2D 

V2 

C019 

VBLINT 

0C VBLMODE 

FE36 

VERIFY 

FE58 

VFYOK 

CE3 1 VIDMODE 

FBFD 

VIDOUT 

FB78 

VIDWAIT 

F826 VLINEZ 

F828 

VLINE 

FC22 

VTAB 

FB59 VTAB23 

FC30 

VTAB40 

FCA9 

WAIT2 

FCAA WAIT3 

FCA8 

WAIT 

CDD5 

WIN0 

CDE0 WIN1 

CDED 

WIN2 

CE02 

WIN4 

CDD2 WIN40 

CE 1 8 

WIN5 

23 

WNDBTM 

20 WNDLFT 

CE0A 

WNDREST 

21 

WNDWDTH 

C00S WRCARDRAM 

7FECD 

WRITE 

CD8D 

X. CUR. OFF 

CD89 X. CUR. ON 

CDB7 

X.SI 

C3A5 

X .UPSHIFT 

FDB3 X AM 

FDA3 

X AM8 

FEB0 

XBASIC 

C8E6 XBITKBD 

C8F9 

XBKB1 

CAA6 

XBRK 

06FB XCOORD 

C3C0 

XFERAZP 

C3B0 

XFERZP 

C397 XFER 

CAC9 

XJMPAT 

CAC8 

X JMP 

CAC0 X JSR 

CAEE 

XJXNOC 

C5DC 

XMBOUT 

C48E XMCDONE 

C4BD 

XMCLAMP 

C 1 AD 

XMDONE 

C47 1 XMH2 

C46F 

XMHLOOP 

C4B6 

XMRD2 

C493 XMREAD 

D44 1 

XMREAD2 

C8D4 

XNOKEY 

C2D5 XNOSBUF 

93 

XOFF 

CA98 

XQ 1 

CA9A XQ2 

CA64 

XQINIT 

CA90 

XQNTBRA 

3C XQT 

CA4A 

XQWAIT 

C4B 1 

XRBUT2 

D450 XRBUT3 

D457 

XRBUT4 

C8D5 

XRDKBD 

C2E9 XRDNOBUF 

C2C3 

XRDSER 

D0DB 

XREADY 

46 XREG 

C8CC 

XRKBD1 

CAAC 

XRT I 

CAB0 XRTS 

C43B 

XSETMOU 

7C100 

XXX 

0008 YHI 

47 

YREG 

35 

YSAV1 

FFC7 ZMODE 

D4B6 

ZP 1 

D4D2 

ZP3 

D4D7 ZPERROR 

D4E9 

ZZLOOP 
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7C452 
FE 18 
7FB6F 
D1A0 
FE93 
CBC 1 
C45C 
C205 
Cl 
03F2 
C286 
BFF9 
CA43 
C3B8 
C3C1 
C3B3 
FFE3 
C245 
C7AF 
C806 
C78E 
7C788 
C784 
C797 
C82F 
C4FE 
C533 
C7E5 
7FB5B 
06F8 
DF 
CISC 
067F 
05FF 
C055 
CC93 
FC 1 A 
C070 
067B 
FC04 
04FB 
FC24 
FEEB 
CDF2 
CDD4 
22 
C004 
CDB0 
FDC6 
C8FB 
C3AA 
CAE3 
CSCF 
C482 
C46B 
C4DC 
91 
CA50 
C4AA 
C2F4 
C2C9 
C42 1 
C450 
34 
D4BF 
D4E0 


PAGE 108 

SET I OU 
i SETMODE 
SETPWRC 
SETTERM 
SETVID 
SEV1 
SILOOP 
SIN 

SLTDMY 

SOFTEV 

SOTST 

SSTAT 

STEP 

STORCH 

STORE 

STORY 

SUBTBL 

SUDONE 

SWAUX 

SWCMD3 

SWIRQ2 

SWRESET 

SWRTS 

SWSTHK2 

SWTBL0 

SWTST3 

SWTST7 

SWZZNM 

TABV 

TEMP 

TERMCUR 

TOOFAR 

TRSER 

TWKEY 

TXTPAGE2 

UD2 

UP 

VBLCLR 

VFACTV 

VID0UT1 

VMODE 

VTABZ 

WDTHCH 

WIN3 

WIN80 

WNDTOP 

WRMA INRAM 

X.SO 

XAMPM 

XBKB2 

XFERC2M 

XJMPATX 

XMBASIC 

XMCLEAR 

XMHOME 

XMTST I NT 

XON 

XQNOBT0 

XRBUT 

XRDDONE 

XRDSER2 

XRLOOP 

XSOFF 

YSAV 

ZP2 

ZZNM 



SOURCE FILE '01 ->CPCL 
INCLUDE FILE '02 ->PC. EQUATES 
INCLUDE FILE '03 - >PC . BOOTSPACE 
INCLUDE FILE '04 ->PC.BOOT 
INCLUDE FILE '05 ->PC. PACKET 
INCLUDE FILE '06 ->PC.CREAD 
INCLUDE FILE '07 ->PC.MAIN 
0000: 1 LST NGU 

0000: 0001 2 lie equ 1 ;Which machine? 

0000: 0001 3 ROM equ 1 ; RAM or ROM based 

0000: C000 4 TheOrg equ $C000 

0000: 1000 5 version equ $1000 

0000 : 6 • 

0000: 0001 7 Ifeq lie 

0000: 9 else 


4^ 

4^ 


01 CPCL 


SmartPort code for A//c 
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0000 

0000 

0000 


0000 

0000 

0000 

0000 

0000 


0000 : 


0000 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 


11 fin 

12 * 

0001 13 X6502 


RRRR TTTTT 

R R T 

RRRR T 

R R T 

R R T 


M M AAA RRRR TTTTT PPPP OOO 
MM MM A AR R T P PO 0 

M M M AAAAA RRRR T PPPP 0 0 

MMAARR TP 00 

MMAARRTP 000 


21 * Protocol Converter Code for the Apple //c 


23 * 

24 • 

25 • 

26 • 

27 • 

28 • 

29 • 

30 * 

31 

32 • 


UnlDlsk 3.5 Driver Firmware Version 1.0 

Hrltten by Michael Asklns x6243 May IS, 1985 

Copyright Apple Computer, Inc. 1985 ' 

All Rights Reserved 

MSB ON 



SmartPort code for A//c 
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4 ^ 

4- 


CO 


91 CPCL 

0000 : 
0000 : 


34 • 

35 Include pc. equates 


02 PC. EQUATES 


Equates 


29- JUL-85 15:19 PAGE 4 





4 - 

CO 


02 PC. EQUATES 


Equates 
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0000! 00C8 148 packetend equ $C8 ;End of packet mark 

0000 ! 0080 149 cmdmar k equ $80 ‘.Command packet identifier 

0000 ! 0081 150 statmark equ $81 '.Status Packet identifier 

0000 ! 0082 1S1 datamark equ $82 ‘.Data Packet identifier 

0000: 152 • 

0000 : 0007 153 iwmmode equ $07 ;No timer, asynch, latch 

0000: 154 • 

0000: 0000 155 SCDeviceStat equ 0 ;Get Device Specific Status 

0000: 0001 15G SCGetDCB equ 1 ;Get Dev Ctrl Block (modebits) 

0000: 0002 157 SCRetNLStat equ 2 jReturn Newline Status 

0000: 0003 158 SCGetDev I nf o equ 3 ;Get Device Info Block 

0000: 159 • 

0000: C080 160 iwm equ $C080 

0000: 161 • 

0000: C080 162 reqclr equ iwm*0 

0000: C081 163 reqset equ iwm*1 

0000: C082 164 calclr equ iwm*2 

0000: C083 165 calset equ iwm*3 

0000: C084 166 ca2clr equ iwm*4 

0000: C085 167 ca2set equ iwm+5 

0000: C086 168 lstrbclr equ iwm+6 

0000: C087 169 lstrbset equ iwm*7 

0000: C088 170 monclr equ iwm+8 

0000: C089 171 monset equ iwm*9 

0000: C08A 172 enablel equ iwm+10 

0000: C08B 173 enable2 equ lwm*11 

0000: C08C 174 16clr equ iwm+12 

0000 : C08D 175 16set equ iwm+13 

0000: C08E 176 17clr equ iwm*14 

0000: C08F 177 17set equ iwm*15 

0000: 178 • 

0000: 179 • 

0000: 180 • Error0 codes 

0000: 181 * 

0000: 0001 182 noanswer equ 1 

0000: 0002 183 nomark equ 2 

0000: 0004 184 wasreset equ 4 

0000: 0008 185 bytecmp equ 8 

0000: 0010 186 csumerr equ $10 

0000: 0020 187 nopackend equ $20 

0000: 0040 188 bushog equ $40 

0000: 189 • 

0000: 190 • Command Codes 

0000: 191 • 

0000: 0000 192 StatusCmd equ $00 

0000: 0001 193 ReadCmd equ $01 

0000: 0002 194 UriteCmd equ $02 

0000: 0003 195 FormatCmd equ $03 

0000: 0004 196 ControlCmd equ $04 

0000: 0005 197 InitCmd equ $05 

0000: 198 * 

0000: 199 • 

0000: 0040 200 Soft equ X01000000 ;The soft error bit in statbyte 

0000 : 201 • 

0000: 0001 202 BadCmd equ $01 

0000: 0004 203 BadPCnt equ $04 

0000: 0006 204 BusErr equ $06 

0000: 0011 205 BadUnit equ $11 

0000 : 00 IF 206 Nolnt equ $1F 

0000: 0021 207 BadC 1 1 equ $21 

0000: 0022 208 BadCt IParm equ $22 

0000: 0027 209 IOError equ $27 

0000: 0028 210 NoDrive equ $28 

0000 : 002B 211 WriteProt equ $2B 

0000: 002D 212 BadBlock equ $2D 

0000: 002F 213 Of f Line equ $2F 

0000: 0068 214 LastOne equ Soft*NoDrive 

0000: 0067 215 SoftError equ SoftMQError 

0000: 216 • 

0000: 0010 217 SVMaskl equ $10 

0000: 218 • 




CS00: 

C500 : 

C500 : 

C500 : 

C500 : 

C500 : 

C500 : 

C500 : 

C500 : 

C500 : 

C500 : A2 20 
C502 : A2 00 
C504 : A2 03 
C50G : 

CS06 : C9 00 
C508 : 

C508 : B0 17 
C50A : 

C50A : 

C50A : 

C50A : 

C50A : 

C50A : 

C50A : 

C50A : 

C50A : 

C50 A : 38 
C50B : B0 01 
C50D : 

C50D : 

C50D : 

C50D : 

C50D : 18 
C50E : A2 05 
C5 1 0 : 7E 73 04 
C513: 18 
C514: 

C514: 

CS14 : 

C514 : 

C5 1 4 : A2 C5 
C5 16 : 8E F8 07 
C5 19 : A2 05 
C5 IB : AD FF CF 
C51E: 

C51E: 

C5 1 E : 4C 97 C7 
C52 1 : 

C52 1 : A2 05 
C523 : 

C523 : 

C523: 

C523: 

C523: 

C523: 

C523: 


0500 


000 1 

0521 

C50 A 

C50E 

C50D 

C514 

000 1 

C521 


947 1st on 

948 • 

949 • Here beginneth that code which resldeth in the boot space 

950 • at the time the card resteth in slot the fifth. 

951 • 

952 C500orq equ * 

953 • 

954 • Auto Boot signature bytes 

955 * This is also the boot (auto « PR#5) entry point. 

956 • r 

957 ldx #$20 

958 ldx #$00 

959 ldx #$03 

960 • 

961 cmp #0 {Flag that this is a boot 

962 do IIc A R0M 

963 bcs BootC 

964 else 

966 fin 

967 * 

968 • Here is the ProDOS normal entry point 

969 • 

970 ProDOSEntry equ • 

971 • 

972 • Set up so that ProFLAG will have the top bit set 

973 • 

974 sec 

975 bcs **3 ;Skip the clear 

976 • 

977 • This is the MLIxface entry point 

978 • 

979 MLIEntry equ • ;0nly use this label in //c version 

980 clc 

981 ldx #$05 

982 ror ProFLAG, x ; ProFLAG! 7 1 - 1 if ProDOS, -0 if ML I 

983 clc ;This is not a boot entry 

984 * 

985 * Now save mslot and clear all $C800 ROMs 

986 • 

987 bootcase5 equ • 

988 ldx #$C5 ; Load value for MSLOT 

989 s t x MS lot 

990 ldx #$05 

991 Ida C 1 ear I OROMs ;Clear all $C800 latches but ours 

992 • 

993 do IIc A R0M 

994 Jmp SWPR0T0 

995 BootC equ • 

996 ldx #$05 ;Need slot number 

997 else 

1189 fin 

1190 • 

1659 1st on 

48 • 

49 do IIc a R0M 

50 Include pc. boot 
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C523 : 

C523 : C523 

C523 : 86 58 
C525 : 

C525 : 0001 

C525 : A9 C5 
C527 : 8D F8 07 
C52A : 20 76 C5 
C52D : 

C52D: 

C52D: 

CS2D : A0 05 
C52F : B9 70 CS 
C532 : 99 42 00 
C535 : 88 

C536: 10 F7 C52F 
C538: 

C538 : 

C538 : 

C538: 0001 

C538 : 

C538 : 

C538 : 

C538 : 

C538 : 0001 

C538 : 20 0A C5 
CS3B: 

CS3B: 

C53B : B0 IS C552 
C53D : 

C53D : AE 00 08 
C540 : CA 

C54 1 : D0 0F C552 
C543 : 

C543 : AE 01 08 
C546 : F 0 0A C552 
C548 : 

C548 : 

C548 : 

C548 : A5 58 
C54A : 0A 
C54B : 0 A 
C54C : 0A 
C54D : 0A 
C54E : AA 
C54F : 4C 01 08 
C552 : 

C552 : 

C552 : 

C552 : 

C552 : 

C552: 

C552 : C552 

C5S2: 

C552 : 0001 

C552 : A2 10 
CS54 : C554 

CS54.-BD 5F C5 
C557 : 9D DB 07 
C55A : CA 

C55B: 10 F7 C554 

C55D : 80 FE C55D 

C55F : 

C55F : C3 E8 E5 E3 
C570 : 0011 

C570 : 

C570 : 

C570: 

C570 : 0 1 50 00 08 
C576: 

C576 : 



CM 
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C576: 

C576: 

C576: 

C576: 0001 

C576 : C576 

C576 : A2 08 
C578 : CS78 

C578 : BD 83 C5 
C57B : 95 00 
C57D : CA 

C57E : 1 0 F8 C578 
C580 : 4C 00 00 
C583 : 

C583 : C583 

CS83 : 20 0D CS 
C586 : 05 
C587 : 07 00 


NEXT OBJECT FILE NAME IS CPCL.1 
C5F5 : C5F5 51 org 

C5F5 : 4C 52 CS 52 imp 

C5F8 : 4C 76 CS 53 imp 

C5FB : 00 54 dfb 

C5FC : 00 00 55 dw 

C5FE : BF 56 dfb 

C5FF : 0A 57 dfb 

C600 : 58 * 

NEXT OBJECT FILE NAME IS CPCL.2 


136 * This routine Is called from the //c reset code. It forces 

137 • reset of the PC Bus. 

138 • 

139 do IIc a ROM 

140 Reset equ * 

141 ldx #8 

142 rstl equ • 

143 Ida rcode,x 

144 sta 1 oc0 , x 

145 dex 

146 bpl rstl 

147 imp loc0 

148 • 

149 rcode equ • 

150 Jsr MLIEntry 

151 dfb InitCMD 

152 dw $0007 

153 r t 5 

154 • 

155 cmdllst dfb 1,0 ;0ne parm - the unit $00 

156 fin 

157 • 

158 • 


$C5F5 
bootfal 1 
reset 
PCID2 

0 

PDIDByte 
>Pr oDOSEnt ry 


AppleTal kEntry 


; Jump to the boot failure message 
;Reset vector 


;The //c bank switch jumps here 


C886 

C886 

C886 


64 include pc. packet 

1 *lst eye 

2 * 
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C8AF : 

C8AF : B9 D6 C9 
C8B2 : 

C8B2 : 

C8B2 : IE 8C C0 
C8B5 : 90 FB C8B2 
C8B7 : 

C8B7 : 9D 8D C0 
C8BA : 88 

C8BB : 1 0 F2 C8AF 
C8BD : 

C8B0 : 

C8BD: 

C8BD : A5 5A 
C8BF : 09 80 
C8C 1 : 20 53 CA 
C8C4 : 

C8C4: 

C8C4: 

C8C4 : 20 51 CA 
C8C7 : 

C8C7 : 

C8C7: 

C8C7 : A5 5B 
C8C9 : 20 S3 CA 
C8CC : 

C8CC: 

C8CC: 

C8CC : 20 51 CA 
C8CF : 

C8CF : 

C8CF : 

C8CF : 20 SI CA 
C8D2 : A5 4C 
C8D4 : 09 80 
C8D6 : 20 53 CA 
C8D9 : A5 4B 
C8DB : 09 80 
C8DD : 20 53 CA 
C8E0 : 

C8E0 : 

C8E0 : 

C8E0 : A5 4C 

C8E2 : F 0 15 C8F9 

C8E4: 

C8E4 : A0 FF 
C8E6 : A5 59 
C8E8: 

C8E8 : 1 E 8C C0 

C8EB : 90 FB C8E8 

C8ED : 9D 8D C0 

C8F 0 : C8 

C8F 1 : B 1 54 

C8F3 : 09 80 

C8F5 : C4 4C 

C8F7 : 90 EF C8E8 

C8F9 : 

C8F9 : 

C8F9 : 

C8F9 : 

C8F9 : C8F9 

C8F9 : A5 4B 
C8FB : D0 03 C900 

C8FD : 4C 99 C9 
C900 : 

C900 : C900 

C900 : EA 

C90 1 : A0 00 

C903 : A5 41 

C905 : 9D 8D C0 

C908: 


75 * 

78 ssb Ida preamble, y 

77 • 

78 • 

79 ssd asl 16clr,x ;Walt 'til buffer empty 

80 bcc ssd 

81 • 

82 sta 16set,x 

83 dey 

84 bpl ssb ; Back for more bytes 

85 * 

86 • Send over the desination ID 

87 • 

88 Ida Unit 

89 ora *$80 ;Make the device ID 

90 Jsr sendbyte 

91 • 

92 * Send the source ID (that's us... we're an $80) 

93 • 

94 jsr send80 

95 • 

96 * Send over the packet type (command or data) 

97 • 

98 Ida Mpackettype 

99 Jsr sendbyte 

100 • 

101 * Send the Auxilliary Type byte (an $80 from this rev PC) 

102 • 

103 Jsr send80 

104 • 

105 * Send the status byte (null for us), and length bytes 

106 • 

107 Jsr send80 

108 Ida oddbytes 

109 ora *$80 

110 jsr sendbyte 

111 Ida grp7ctr 

112 ora *$80 

113 jsr sendbyte 

114 • 

115 • Now send the "oddbytes" part of the packet contents 

117 Ida oddbytes ;Get * of "odd" bytes 

118 beq sob2 iSkip if no odd bytes 

119* 

120 ldy *$FF 

121 Ida tbodd ;Get the odd bytes msb's (AI71-1) 

122 * 

123 sobl asl 16clr,x ; Do a write handshake 

124 bcc sobl 

125 sta 16set , x 

126 iny 

127 Ida (buffer), y ;Get the data byte 

128 ora *$80 ; F 1 i p on the hi bit 

129 cpy oddbytes ;Are we done? 

130 bit sobl 

131 • 

132 • Now send over the groups of seven contents 

133 * Currently assume there must be at least one group of 'em 

134 • 

135 sob2 equ # 

136 Ida grp7ctr ;Check if there are groups to send 

137 bne sob3 ;-> At least one group 

138 jmp datdone ;Skip to send checksum 

139 • 

140 sob3 equ * 

141 nop ;Maste 2 cycles 

142 ldy *0 

143 start Ida topbits 

144 sta 16se t , x 

145 • 
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C908 : 



146 

• Send 

first byt 

e 


C908 : 



147 

• 



C908 : A5 

4D 


148 


1 da 

nex 1 1 


C90 A : 09 

80 


149 


ora 

'$80 


C90C : 84 

59 


150 


sty 

temp 

;Swap Y for short handshake 

C90E : BC 

8C 

C0 

151 

ache 1 

ldy 

16c 1 r , x 

;UJait 'til buffer ready 

C91 1 : 10 

FB 

C90E 

152 


bp 1 

a c he 1 

C913:9D 

8D 

C0 

153 


s ta 

16set , x 

;Send the byte 

C916: A4 

59 


154 


ldy 

temp 

; Ge t back Y 

C918: 



155 

• 


C918: 



156 

• Prep 

the next 

" 1st'* byte for 

next time 

C918: 



157 



C9 1 8 : B 1 

56 


158 


Ida 

(buf fer2) ,y 


C9 1 A : 85 

4D 


159 


s ta 

next 1 


C9 1 C : 0 A 



160 


as 1 

a 


C9 1 D : 26 

41 


161 


rol 

topbi ts 

; S t or e the top bit 

C9 1 F : C8 



162 


i ny 

;Next byte 

C920 : 



163 

• 



C920: 



164 

• It's 

possible 

that we're at 

a page boundary now. If so, bui 

C920 : 



165 

• hi order part 

of the pointer. 

C920 : 



166 

* 




C920 : D0 

05 

C927 

167 


bne 

sk 1 p 1 


C922 : E6 

57 


168 


inc 

buf f er2* 1 


C924 : 4C 

29 

C9 

169 


Jmp 

skip2 


C927 : 48 



170 

s k 1 p 1 

pha 


;Equalize the cases 

C928 : 68 



171 


pla 



C929 : 



172 




C929: 



173 

• Push 

us ahead 

by an add i t ion 

al 8 cycles for margin reasons 

C929: 



174 

• Plus 

I gotta 

get the topbit 

s MSB set somehow. . . 

C929 : 



175 



C929: 


C929 

176 

sklp2 

equ 

• 


C929 : A9 

02 


177 


Ida 

'X00000010 

;Fllp what will be MSB 

C92B : 05 

41 


178 


ora 

topbi ts 

C92D : 85 

41 


179 


s ta 

topbi ta 


C92F : 



180 

• 



C92F : 



181 

• Send 

the second byte 


C92F : 



182 

• 




C92F : A5 

4E 


183 


Ida 

next2 


C931 : 09 

80 


184 


ora 

'$80 


C933 : 9D 

8D 

C0 

185 


s ta 

16se t , x 

;Send the byte 

C936 : B 1 

56 


186 


Ida 

(buf fer2) ,y 

C938 : 85 

4E 


187 


s ta 

next2 


C93A : 0 A 



188 


as 1 

a 


C93B : 26 

41 


189 


rol 

topbi ts 

j Store the top bit 

C93D : C8 



190 


iny 

;Next byte 

C93E : 



191 

• 




C93E : 



192 

• Send 

the third 

1 byte 


C93E : 



193 

• 



C93E : AS 

4F 


194 


Ida 

nex t3 


C940 : 09 

80 


195 


ora 

'$80 


C942 : 9D 

8D 

C0 

196 


s ta 

1 6se t , x 

; Send the byte 

C945 : B 1 

56 


197 


Ida 

(buf fer2) ,y 

C947 : 85 

4F 


198 


sta 

next3 


C949 : 0 A 



199 


as 1 

a 


C94A : 26 

41 


200 


rol 

topbi ts 

;Store the top bit 

C94C : C8 



201 


iny 

; Next byte 

C94D : 



202 

• 



C94D : 



203 

• Send 

the fourth byte 


C94D : 



204 

• 




C94D : AS 

50 


205 


1 da 

next4 


C94F : 09 

80 


206 


ora 

'$80 


C951 :9D 

8D 

C0 

207 


sta 

16set , x 

;Send the byte 

C954 : B 1 

56 


208 


Ida 

(buffer2),y 

C956 : 85 

50 


209 


sta 

next 4 


C958 : 0 A 



210 


as 1 

a 


C959 : 26 

41 


211 


rol 

topbi ts 

; Store the top bit 

C95B : C8 



212 


iny 

; Next byte 

C95C : 



213 

• 




C95C: 214 • After the first 256 bytes, we will cross pages here. If we 
C95C: 215 * cross, bump the buffer pointer. If not, equalize the cases 
C95C: 216 * seven cycles of time wasting. 



— -1 
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4 ^ 

4 - 

oo 


BD 8C C0 
29 40 

D0 F9 C9B2 


BD 8E C0 
30 F 0 C9BE 


BD 80 C0 
BD 8C C0 
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C9DC: 

C9DC: 

C9DC: 

C9DC: 

C9DC : 20 El C9 
C9DF : EA 
C9E 0 : E A 
C9E 1 : EA 
C9E2 : 60 
C9E3: 

C9E3 : 

C9E3 : C9E3 

C9E3 : 4C C3 C9 


335 

336 

337 

338 

339 

340 
34 1 

342 

343 

344 

345 

346 

347 


* These routines are for wasting specific amounts of time 

• This code segment should not cross page boundaries. 

waste32 Jsr waste14 
waste18 nop 
waste16 nop 
waste14 nop 
was t e 1 2 rts 


markerr equ • 

jmp dberror 
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C9E6 : 

C9E6 : 

C9E6 : 

C9E6 : 

C9E6 : 

C9E6 : 

C9E6 : 

C9E6 : 

C9E6 : 

C9E6: 

C9E6: 

C9E6: 

C9E6 : 

C9E6 : 

C9E6 : 

C9E6 : 

C9E6: 

C9E6 : 

C9E6: 

C9E6 : 

C9E6: 

C9E6: 

C9E6: 

C9E6 : 

C9E6 : 

C9E6 : 

C9E6: 

C9E6: 

C9E6 : C9E6 

C9E6 : C9E6 

C9E6 : 

C9E6 : 

C9E6 : 

C9E6 : A9 00 
C9E8 : 85 40 
C9EA : 

C9EA : 

C9EA : 

C9EA : A5 54 
C9EC : 85 56 
C9EE : A5 55 
C9F 0 : 85 57 
C9F2: 

C9F2: 

C9F2: 

C9F2: 0001 

C9F2 : 

C9F2: 

C9F2 : 20 80 CA 
C9F5 : 

C9F5 : BD 8D C0 
C9F8 : 

C9F8 : 

C9F8 : 

C9F8 : BD 8E C0 
C9FB : 1 0 FB C9F8 
C9FD : 

C9FD : 

C9FD : 

C9FD : BD 81 C0 
CA00 : 

CA00 : 

CA00 : 

CA00 : A0 IE 
CA02 : BD 8C C0 
C A05 : 10 FB CA02 
CA07 : 88 

CA08 : 30 D9 C9E3 
CA0A : 

CA0A : 

CA0A : 


349 

350 • 

351 • RecelvePack Get a packet from bus resident 

352 • 

353 • 

354 • REQ 12 Si * 

355 • 

356 • /BSY ll 3 4l * 

357 * 

358 • 1) Drive signals ready to send packet 

359 • 2) Host signals ready to recieve data 

360 * 3) Packet is transmitted (sync, mark, IDs, data, 

361 • checksum tmsb-11) 

362 • 4) Drive signals packet dispatched 

363 * 5) Host acknowledges reciept of packet 

364 * 

365 • The bytes are sent in slow mode (32 cycles/byte) 

366 * and the timing is critical. Branches which should 

367 * not cross page boundaries are marked. 

368 • 

369 • Input: buffer <- address where packet guts left 

370 • 

371 • Output: carry set- handshake error 

372 • clr- bytes recleved 

373 • A < - error0 if carry set 

374 * 

375 

376 • 

377 grabstatus equ * 

378 RecelvePack equ • 

379 • 


380 

* Init 

the checksum 


381 

• 




382 


Ida 

#$00 


383 


sta 

checksum 


384 

* 




385 

• Copy 

over buffer -> buffer2 


386 




387 


Ida 

buffer 


388 


sta 

buf f er2 


389 


1 da 

buffer* 1 


390 


sta 

bu f f er 2* 1 


391 

• 




392 

• Set u 

p the indirect pointer 

for jump to 2nd part of code 

393 

* 



394 


1 f eq 

I I c*ROM 

;Don't do in //c version 

401 


fin 



402 

• 




403 


jar 

enablechai n 

; Se t X register to $N0 

404 

• 



405 


Ida 

16set , x 

; Pr ep for sense mode 

406 

• 




407 

* Now w 

ait for BSY to go hi , 

signalling 'ready w/ status' 

408 

• 




409 

rdh 1 

Ida 

17c 1 r , x 

;Read sense 

410 


bpl 

rdh 1 

; Wa 1 t til a high 

411 

• 




412 

• Signs 

1 Liron v« 

e're ready to 

recieve 

413 

• 




414 


Ida 

reqset , x 

; Ra 1 se /REQ 

415 

• 




416 

• Wait 

for a byt 

e from Liron 

or timeout 

417 

• 



418 


ldy 

#statmto 

;Max bytes 'til stat mark 

419 

rdh2 

Ida 

16c 1 r , x 

420 


bpl 

rdh2 

No Page Cross 

421 


dey 



422 


bmi 

marker r 

; Di dn ' t find a packet in time 

423 

• 



424 

• la it 

the begl 

nnlng of the 

packet? 

425 

• 
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CA0 A : C9 C3 

CA0C : D0 F 4 CA02 

CA0E : 

CA0E : 

CA0E : 

CA0E : CA0E 

CA0E : 

CA0E : A0 06 
CA 1 0 : BD 8C C0 
CA 13:10 FB CA10 
C A 1 5 : 29 7F 
CA 1 7 : 99 4B 00 
C A 1 A : 49 80 
CA 1C : 45 40 
CA 1 E : 85 40 
CA20 : 88 

CA21 : 1 0 ED CA10 
CA23 : 

CA23 : 

CA23 : 

CA23 : AS 4C 

CA25 : F0 27 CA4E 

CA27 : 18 

CA28:65 54 

CA2A : 85 56 

CA2C : A5 55 

CA2E : 69 00 

CA30 : 85 57 

CA32 : 

CA32 : A0 00 
CA34 : 

CA34 : 

CA34 : 

C A34 : BD 8C C0 


CA37 : 1 0 FB CA34 

CA39 : 0A 

CA3A : 85 41 

CA3C : CA3C 

CA3C : BD 8C C0 

CA3F : 1 0 FB CA3C 

CA4 1:06 41 

CA43 : B0 02 CA47 

CA45 : 49 80 

CA47 :91 54 

CA49 : C8 

CA4 A : C4 4C 

CA4C : 90 EE CA3C 

CA4E : 

CA4E : CA4E 

CA4E : 0001 


CA4E : 4C 72 CC 
CA51 : 

CA5 1 : 

CA5 1 : 

CAS1 : CA5 1 

CA5 1 : A9 80 
CA53: CA53 

CA53 : BC 8C C0 
CA56 : 1 0 FB CA53 
CA58 : 9D 8D C0 
CA5B : 45 40 
CA5D : 85 40 
CA5F : 60 
CA60 : 

CA60 : 

CA60 : 

CA60 : 

CA60 : CA60 

CA60 : 20 8A CA 
CA63 : BD 81 C0 
CA66 : BD 85 C0 


426 cmp #packetbeg 

427 bne rdh2 

428 « 

429 * Okay load up the table with 

430 * 

431 rdh5 equ • 

432 • 

433 ldy #6 

434 rdh3 Ida 16clr,x 

435 bpl rdh3 

436 and #*01111111 

437 sta rcvbuf,y 

438 eor #$80 

439 eor checksum 

440 sta checksum 

441 dey 

442 bpl r dh3 

443 • 

444 • Set groups of seven buffer 

445 • 

446 Ida oddbytes 

447 beq start2 

448 c 1 c 

449 adc buffer 

450 sta buffer2 

451 Ida buffer+1 

452 adc #0 

453 sta buf f er2* 1 

454 • 

455 ldy #0 

456 • 

457 * Now receive the odd bytes 

458 • 

459 s t ar 1 0 Ida 16clr,x 

460 bpl start0 

461 asl a 

462 sta topbits 

463 startl equ • 

464 Ida 16clr,x 

465 bpl startl 

466 asl topbits 

467 bcs gob 1 

468 eor '$80 

469 gobl sta (buffer), y 

470 iny 

471 cpy oddbytes 

472 bit startl 

473 « 

474 s tar t2 equ • 

475 do I I c“ROM 

476 Imp SlotDepRd 

477 else 

479 fin 

481 Send80 equ 

482 Ida #$80 

483 SendByte equ • 

484 ldy 16c 1 r , x 

485 bpl SendByte 

486 sta 16set,x 

487 eor checksum 

488 sta checksum 

489 rts 

490 • 

491 • 

492 • 

493 • 

494 resetchain equ • 

495 Jar ClrPhases 

496 Ida reqset.x 

497 Ida ca2set , x 


;Find the packet begin mark 
;Back again - no timeout for now 

this stuff 


;Seven bytes of overhead 
;If byte ready, grab it 
;••• No Page Cross *•* 

; Str ip start bit 

;Pop MSB back on for checksum 


pointer buffer2 


;Sklp alteration if no oddbytes 


;Read in the odd bytes topbits 
;Pop off the start bit 


;Get an odd byte 
;Get an MSB 

;If MSB set, leave start bit 
;MSB clear- flip start bit 
;Squirrel it away 
; Nex t spot 
;Are we done? 

; I f more, branch 
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CA69: A0 

50 


498 


1 dy 

'80 ;Hard reset for 80 

ms 

CADD: 



562 

• 



CA6B : 20 

73 

CA 

499 


Jsr 

YMSWait 


CADD: 


CADD 

563 

SendData 

equ 

• 

CA6E : 



500 

* 




CADD : A9 

05 


564 


1 da 

'>RC2 

CA6E : 20 

8A 

CA 

501 


jsr 

ClrPhases 


CADF : A0 

00 


565 


1 dy 

'<RC2 

CA7 1 : 



502 

* 




CAE 1 : 20 

00 

CB 

566 


Jsr 

SendP i 1 e 

CA7 1 : A0 

0 A 


503 


ldy 

'10 ;About 10 mS reset 

t ime ! 

CAE4 : 90 

05 

CAEB 

567 


bcc 

sdoubt 

CA73 : 



504 

• 




CAE6 : A9 

80 


568 


Ida 

'CommReset 

CA73 : 


CA73 

505 

YMSWait 

equ 

• 


CAE8 : 20 

90 

CF 

569 


Jsr 

AssignID 

CA73 : 20 

7A 

CA 

506 


Jsr 

OneMS 


CAEB : 


CAEB 

570 

sdoubt 

equ 

• 

CA76 : 88 



507 


dey 



CAEB : 60 



571 


rts 


CA77 : D0 

FA 

CA73 

508 


bne 

YMSWait 


CAEC : 



572 

• 



CA79: 60 



509 


r ts 



CAEC: 



573 

* 



CA7A : 



510 

• 




CAEC: 


CAEC 

574 

SendPac k 

equ 

* 

CA7A : 


CA7A 

511 

OneMS 

equ 

• 


CAEC : 20 

00 

CB 

575 


jsr 

SendPi le 

CA7A : A2 

C8 


512 


ldx 

'200 


CAEF : 90 

FA 

CAEB 

576 


bcc 

sdoubt 

CA7C : CA 



513 

onems 1 

dex 



CAF 1 : A9 

80 


577 


1 da 

'CommReset 

CA7D: D0 

FD 

CA7C 

514 


bne 

onems 1 


CAF3 : 20 

90 

CF 

578 


Jsr 

AssignID 

CA7F : 60 



515 


rts 



CAF6 : 



579 

• 



CA80: 



516 

• 




CAF6 : AD 

F8 

06 

580 


1 da 

SvBcL 

CA80 : 



517 

• 




CAF9 : 85 

4D 


581 


s ta 

by tecount 1 

CA80: 


CA80 

518 

enablechain equ 

• 


CAFB : AD 

78 

07 

582 


Ida 

SvBcH 

CA80 : 20 

9A 

CA 

519 


Jsr 

Set XN0 


CAFE : 85 

4E 


583 


s ta 

by tecounth 

CA83 : BD 

83 

C0 

520 


Ida 

ca 1 set , x 


CB00 : 



584 

• 



CA86 : BD 

87 

C0 

521 


Ida 

1 s t rbse t , x 


CB00 : 


CB00 

585 

SendP lie 

equ 

• 

CA89 : 60 



522 


rts 



CB00 : A9 

B8 


586 


1 da 

'>RC 1 

CA8A : 



523 

• 




CB02 : A0 

0B 


587 


1 dy 

'<RC 1 

CA8A : 



524 

* 




CB04 : 



588 

• 



CA8A : 


CASA 

525 

ClrPhases equ 

• 


CB04 : 


CB04 

589 

AltSendPile equ 

• 

CA8A : 20 

9A 

CA 

526 


J» r 

Se t XN0 


CB04 : A6 

58 


590 


ldx 

slot 

CA8D : BD 

80 

C0 

527 


Ida 

reqclr , x 


CB06 : 9D 

F3 

04 

591 


s ta 

Retry, x 

CA90 : BD 

82 

C0 

528 


1 da 

ca 1 c 1 r , x 


CB09 : 98 



592 


tya 


CA93 : BD 

84 

C0 

529 


1 da 

ca2c 1 r , x 


CB0A : 9D 

73 

05 

593 


s ta 

Retry2 , x 

CA96 : BD 

86 

C0 

530 


1 da 

lstrbclr , x 


CB0D : 



594 

• 



CA99 : 60 



531 


rts 



CB0D : 



595 

• SendPack 

: dest 

roys the byti 

CA9A : 



532 

* 




CB0D : 



596 

• 



CA9A : 



533 

# 




CB0D : 


CB0D 

597 

spi le 1 

equ 

• 

CA9A : 


CA9A 

534 

Se t XN0 

equ 

• 


CB0D : A5 

4D 


598 


1 da 

by tecount 1 

CA9A : 


0001 

535 


do 

lie 


CB0F : 8D 

F8 

06 

599 


s ta 

SvBcL 

CA9A : A2 

60 


536 


1 dx 

'$60 


CB 1 2 : A5 

4E 


600 


1 da 

by tecounth 

CA9C : 



537 


else 



CB 1 4 : 8D 

78 

07 

601 


s ta 

SvBcH 

CA9C : 



544 


fin 



CB 17: 



602 

• 



CA9C : 



545 

• 




CB 1 7:20 

86 

C8 

603 


Jsr 

SendOnePac k 

CA9C : 60 



546 


rts 



CB1 A : 



604 

* 



CA9D : 



547 

• 




CB1A.-AD 

F8 

06 

605 


Ida 

SvBcL 

CA9D: 



548 

• Shift 

tables 

for use when reading. Each table 

should not 

CB 1 D : 85 

4D 


606 


sta 

by tecount 1 

CA9D: 



549 

• straddle pages. 


CB1F.-AD 

78 

07 

607 


1 da 

SvBcH 

CA9D : 



550 

• 




CB22 : 85 

4E 


608 


sta 

by tecounth 

CA9D : 80 

80 

80 80 

551 

s h 1 f 1 1 

dfb 

$80 , $80 , $80 , $80 , $80 , $80 , $80 , $80 


CB24 : 



609 

• 



CAA5 : 0 0 

00 

00 00 

552 


dfb 



CB24 : 90 

0C 

CB32 

610 


bcc 

spi lout 

CAAD : 80 

80 

80 80 

553 

shif t2 

dfb 

$80, $80, $80, $80, 0,0, 0,0 


CB26 : A6 

58 


61 1 


ldx 

slot 

CAB5 : 80 

80 

80 80 

554 


dfb 

$80, $80, $80, $80, 0,0, 0,0 


CB28 : DE 

F3 

04 

612 


dec 

Retry ,x 

CABD : 80 

80 

00 00 

555 

shif t3 

dfb 

$80, $80, 0,0, $80, $80, 0,0 


CB2B : D0 

E0 

CB0D 

613 


bne 

spi lei 

CAC5-.80 

80 

00 00 

556 


dfb 

$80, $80, 0,0, $80, $80, 0,0 


CB2D : DE 

73 

05 

614 


dec 

Re t ry2 , x 

CACD : 80 

00 

80 00 

557 

shif t4 

dfb 

$80,0, $80,0, $80,0, $80,0 


CB30: 10 

DB 

CB0D 

615 


bpl 

spi lei 

CAD5 : 80 

00 

80 00 

558 


dfb 

$80,0, $80,0, $80,0, $80,0 


CB32 : 60 



616 

spi lout 

rts 


CADD: 



559 

• 




CB33: 



617 

• 



CADD: 



560 

• 




CB33: 


CB33 

618 

RecPacIc 

equ 

• 









CB33 : A4 

58 


619 


ldy 

Slot 









CB35 : A9 

05 


620 


Ida 

'>RC2 









CB37 : 99 

F3 

04 

621 


sta 

Retry ,y 









CB3A : 


CB3A 

622 

rpk 1 

equ 

• 









CB3A : 20 

E6 

C9 

623 


Jsr 

RecelvePack 









CB3D : 90 

0F 

CB4E 

624 


bcc 

rpou t 









CB3F : A0 

01 


625 


ldy 

#1 









CB4 1:20 

73 

CA 

626 


Jar 

YMSWait 









CB44 : 20 

C3 

C9 

627 


sr 

dber ror 









CB47 : A6 

58 


628 


ldx 

Slot 









CB49 : DE 

F3 

04 

629 


dec 

Retry ,x 









CB4C : D0 

EC 

CB3A 

630 


bne 

rpk 1 









CB4E : 


CB4E 

631 

rpou t 

equ 

• 









CB4E : 60 



632 


rts 
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;Try to send a pack 


;Thls Is a communications failure 
; Rese t to try again 


;Get back the packetlength 


;Retry count (big!) 


;Send the packet 


;If all falls, carry Is set 


;Recycle handshake and set carry 


; Carry set still 



05 PC. PACKET 


CB4F : 
CB4F : 


Receive a CBus Packet 


633 

634 


29- JUL-85 15:19 PAGE 21 


24 49 
04 0 1 
01 02 04 
01 02 04 

7F FF 

CB64 

CB64 
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CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 
CB4F : 00 
CB52 : 00 
CB55 : 00 
CB5B : 00 
CB61 : 
CB6 1:00 
CB64 : 
CB64: 
CB64: 
CB64 : 
CB64: 
CB64: 
CB64: 
CB64 : A6 
CB66 : F 0 
CB68: 
CB68 : A5 
CB6A : 85 
CB6C: 
CB6C : A9 
CB6E :E0 
CB70 : F 0 
CB72 : 
CB72 : E6 
CB74 : A9 
CB76: 18 
CB77 :65 
CB79 : 85 
CB7B : 
CB7B: 
CB7B: 
CB7B : 
CB7B : 
CB7B : BD 
CB7E : 85 
CB80 : BD 
CB83 : 85 
CB85: 
CB85: 
CB85: 


Divide by 7 routine 
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52 CB 
4C 


CB85: 

CB85: 

CB85 : A2 05 
CB87 : A5 4D 
CB89 : 85 59 
CB8B : 29 07 
CB8D : A8 
CB8E : 

CB8E : 

CB8E : 06 59 
CB90 : 90 IS CBA7 
CB92 : BD 5B CB 
CB95: CB95 

CB95: 18 


CB8E 


636 

637 

638 

639 

640 

641 

642 

643 

644 

645 

646 

647 

648 

649 

650 

651 

652 

653 

654 

655 

656 

657 

658 

659 

660 
661 
662 

663 

664 

665 

666 

667 

668 

669 

670 

671 

672 

673 

674 

675 

676 

677 

678 

679 

680 
681 
682 

683 

684 

685 

686 

687 

688 

689 

690 

691 

692 

693 

694 

695 

696 

697 

698 

699 

700 

701 

702 

703 

704 

705 

706 


Do DIV and MOD 7 and set auxptr 


Dlvlde7 

This routine divides the bytecount by seven. The 
quotient gives the number of groups of seven bytes to 
be sent, and the remainder gives the number of "odd" 
bytes. 

Input: bytecount 1 , h <- • of bytes to write 

buffer <- pointer to data 

Output: auxptr <- pointer to speed up csumming 

oddbytes <- bytecount MOD 7 

grp7ctr <- bytecount DIV 7 


pdiv7tab dfb 
pmod7 tab dfb 
div7tab dfb 
mod7tab dfb 


0,36,73 

0.4,1 

0,1,2,4,9,18 
0 , 1 ,2,4, 1 ,2 


auxptr Inc dfb 0,$7F,$FF 


WritePrep equ 
Dlvide7 equ 


* Set up auxptr 

• or auxptr 


ldx 

beq 


Ida 

cpx 

beq 

inc 

Ida 

clc 

adc 

sta 


sap 1 


buffer 
buffer 

by tecounth 
noauxp tr 

buffer ♦ 1 
auxptr ♦ 1 

'*80 

#1 

sap 1 

auxptr ♦ 1 

#0 

buffer 

auxptr 


*80 if $0FF < bytecount 
*100 if *1FF < bytecount 


; 0 , 1 or 2 

;Auxptr used only for full pages 


;Copy over hi order part 

;Anticipate smaller bytecount 

;Check bytecount 

;•> *0FF < bytecount < *200 

;Add *100 to bytecount Instead 
;Make sure lo order unaltered 


• Now look up the first order guess for DIV and MOD. 

• bytecount DIV 256. 

noauxptr 


X still has 


Ida pdlv7tab,x 
sta grp7ctr 
Ida pmod7tab,x 
sta oddbytes 

Now add in the mods and diva for each of the five hi order 
bits in the lo order bytecount, correcting each time MOD 
becomes 

bigger than 6. 


ldx 

'5 

;Do for five bits 

Ida 

bytecountl 


sta 

temp 

;Store lo order for shifting 

and 

tay 

'X000001 1 1 

;Save lo three for later 

equ 

• 



as 1 
bcc 
Ida 


temp 
divlde2 
mod7 tab , x 


C <- next from bytecountl 
If clear, no effect on DIV, MOD 
Get M0D7 for 2*n 
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CB96:6S 4C 707 adc oddbytes 

CB98 : C9 07 708 cmp •! 

CB9A : 90 02 CB9E 709 bit dlvldel 

CB9C : E9 07 710 abc #7 

CB9E: CB9E 711 dlvldel equ • 

CB9E:85 4C 712 ata oddbytes 

CBA0:BD 55 CB 713 Ida div7tab,x 

CBA3:65 4B 714 adc grp7ctr 


CBA5:85 4B 715 ate grp7ctr 

CBA7: CBA7 716 dlvlde2 equ • 

CBA7 : CA 717 dex 

CBA8 : 30 06 CBB0 718 bml dlvide5 

CBAA : D0 E2 CB8E 719 bne divide3 

CBAC: 720 * 

CBAC : 98 721 tya 

CBAD:4C 95 CB 722 imp divided 

CBB0 : 723 * 

CBB0 : CBB0 724 divides equ * 

CBB0: 725 • 

CBB0 : 726 * 


Got new MOD value 
la It too big? 

-> NO leave MOD - 0->C 

Bring MOD under 7 - C atill aet 


;Get DIV for thia 2 * t \ 

;Add to DIV along with correction 
CC) 

; Update the DIV 

; One leaa bit to deal with 
;Eacape after 6 times through loop 
;Take brnch 1st 5 loops 

;Get back the last three bits 
; S 1 x th pass add In remains 
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Checksum Prepaas 
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CBB0 : 

CBB0 : 

CBB0 : 

CBB0 : 

CBB0 : 

CBB0 : 

CBB0 : 

CBB0 : 

CBB0 : 

CBB0 : 

CBB0 : 

CBB0 : CBB0 

CBB0 : 

CBB0 : 

CBB0 : 

CBB0 : A5 55 

CBB2 : 48 

CBB3 : A9 00 

CBB5 : A6 4E 

CBB7 : F 0 16 CBCF 

CBB9 : CBB9 

CBB9 : BC 61 CB 

CBBC : CBBC 

CBBC : 5 1 54 

CBBE : 5 1 56 

CBC0 : 88 

CBC 1 : D0 F9 CBBC 

CBC3 : 5 1 54 
CBC5 : 5 1 56 
CBC7: 

CBC7 : 

CBC7 : 

CBC7 : E0 01 

CBC9 : F0 02 CBCD 

CBCB : E6 55 

CBCD : E6 55 

CBCF: 

CBCF: CBCF 

CBCF: 

CBCF: 

CBCF: 

CBCF : A4 4D 

CBD 1 : F0 09 CBDC 

CBD3 : 5 1 54 

CBD5 : 5 1 54 

CBD7 : 88 

CBD8 : D0 FB CBD5 

CBDA : 5 1 54 
CBDC: 

CBDC: 

CBDC: 

CBDC: CBDC 

CBDC: 85 40 

CBDE : 68 

CBDF : 85 55 

CBE 1 : 

CBE1 : 
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Get topblts byte for odds 
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CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : 

CBE 1 : A4 4C 
CBE3 : 88 
CBE 4 : A9 00 
CBE6 : 85 59 
CBE8 : 

CBE8 : B 1 54 
CBEA : 0A 
CBEB : 66 59 
CBED : 88 
CBEE : 1 0 F8 
CBF 0 : 38 
CBF 1 : 66 59 
CBF3: 

CBF3 : A5 4C 
CBF5 : 18 
CBF6 : 65 54 
CBF8 : 85 56 
CBF A : A5 55 
CBFC : 69 00 
CBFE : 85 57 
CC00 : 

CC00 : 


786 

787 • 

788 • DetTopBl ts Get topblts for odd bytes 

789 • 

790 • Also sets buffer2 pointer to pointer at groups of 

791 • seven bytes. 

792 « 

793 * Input: oddbytes <- * of "odd" bytes 

794 • buffer <- pointer to data 

795 * Output: tbodd <- topblts for odd bytes 

796 • buffer2 <- buf f er*oddbytes 

797 • 

798 

799 * 

CBE 1 800 DetTopBl ts . equ • 

801 • 

802 ldy oddbytes 

803 dey 

804 Ida '0 

805 sta tbodd 

807 gtbob Ida (buffer), y 

808 as 1 a 

809 ror tbodd 

810 dey 

CBE8 811 bpl gtbob 

812 sec 

813 ror tbodd 

814 « 

815 Ida oddbytes 

816 clc 

817 adc buffer 

818 sta buffer2 

819 Ida buffer* 1 

820 adc '0 

821 sta buf f er2* 1 

822 • 

823 • 


4^ 


Cn 


CO 
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Pri 


ite pump 
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CC00 




825 


• • • • 



CC00 




826 





CC00 




827 

• Sun 


Set up next buffer and topblts 


CC00 




828 





CC00 




829 

• Primes 

the 

pipe for the group of seven bytes routine 


CC00 




830 

• setting 

the 

topblts byte and the "next" buffer. 


CC00 




831 

• The rou 

tine 

also advances the buffer pointer by 7 to 


CC00 




832 

# prepare 

for 

the groups of seven transfer. 


CC00 




833 

• 




CC00 




834 

• Input 


buffer2 <- points to groups of 7 data 


CC00 




835 

• Output: 

next1,7 <- first 7 bytes in buffer 


CC00 




836 

• 


topbits <- MSBs of first 7 bytes 


CC00 




837 

* 













CC00 




839 

• 




CC00 



CC00 

840 

Sun 

equ 

• 


CC00 




84 1 

• 




CC00 




842 

• Copy first seven bytes into the pipeline 


CC00 




843 





CC00 

A0 

06 


844 


ldy 

#6 


CC02 

38 



845 

sun2 

sec 



CC03 

B 1 

56 


846 


Ida 

(buf fer2) ,y 


CC05 

99 

4D 

00 

847 


sta 

next , y 


CC08 

30 

01 

CC0B 

848 


bmi 

sunl 


CC0A 

18 



849 


clc 



CC0B 

66 

41 


850 

sunl 

ror 

topbi ts 


CC0D 

88 



851 


dey 



CC0E 

10 

F2 

CC02 

852 


bp 1 

sun2 


CC10 

38 



853 


sec 



CC11 

66 

41 


854 


ror 

topbi ts 


CC13 




855 

• 




CC13 




856 

• Advance 

the 

pointer 


CC13 




857 

• 




CC13 

A5 

56 


858 


1 da 

buf f er2 


CC15 

18 



859 


clc 



CC 1 6 

69 

07 


860 


adc 

• 1 


CC18 

85 

56 


861 


sta 

buf f er2 


CC 1 A 

90 

02 

CC1E 

862 


bcc 

sun3 


CC 1C 

E6 

57 


863 


i nc 

buf f er2* 1 


CC IE 



CC1E 

864 

sun3 

equ 

• 


CC IE 

60 



865 


r t s 



CC IF 




866 

• 




CC IF 




867 

* 
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CC IF 
CC IF 
CC IF 
CC1F 
CC1F 
CC 1 F 
CC 1 F 


CC IF : 
CC IF : 


CC IF : 

CC IF : 

CC IF : 

CC IF : CC IF 

CC1F.-BD 88 C0 

CC22 : BD 8D C0 

CC25 : 4C 2C CC 

CC28 : 98 

CC29 : 9D 8F C0 

CC2C : CC2C 

CC2C : 98 

CC2D.-5D 8E C0 

CC30 : 29 IF 

CC32 : D0 F 4 CC28 

CC34 : 60 

CC35: 

CC35 : 

CC35 : 0001 

CC3S : CC35 

CC35 : 

CC35 : 

CC35 : 

CC35 : 20 9A CA 
CC38 : BD 8E C0 
CC3B : BD 8D C0 
CC3E: CC3E 

CC3E : BD 8E C0 
CC4 1 : 29 20 
CC43:D0 F9 CC3E 

CC45 : BD 8C C0 
CC48 : 

CC48 : 

CC48 : 

CC48 : 5A 
CC49 : A0 8C 
CC4B : 88 

CC4C : D0 FD CC4B 

CC4E : 7A 
CC4F : 

CC4F : 60 
CC50 : 

CC50 : 

CC50 : 

CC50 : 

CCS0 : 

CCS0: 

CCS0 : 

CCS0 : CCS0 

CC50 : AS 4B 
CCS2:A8 
CC53 : A2 00 
CC55 : 86 4B 
CC57 : A2 03 
CC59 : 0 A 
CC5A : 26 4B 
CC5C : CA 

CC5D:D0 FA CC59 

CCSF: 18 

CC60 : 65 4 C 

CC62 : 90 02 CC66 

CC64 : E6 4B 

CC66 : 84 4C 


869 • 

870 * X Is slot*16, Y Is the desired mode 

871 • 

872 • Set up the IWM mode register. Extreme care should be taken 

873 • here. Setting the mode byte with indexed stores causes a false 

874 • byte to be written a cycle before the real value is written. 

875 • This false value, if it enables the timer, causes the IWM Rev A 

to 

876 • pop the motor on, inhibiting the setting of the mode until the 

877 • motor times out! We avoid this by setting the mode byte only 

when 

878 • it is not what we want, and if it's not we stay here until we 

879 * see that it is what we want. 

880 • 



936 adc oddbytes 

937 be c 1 7 1 

938 inc grp7ctr 

939 1 7 1 sty oddbytes 
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CC68 : 38 

CC69 : E5 4C 

CC6B : B0 02 CC6F 

CC6D : C6 4B 

CC6F : A4 4B 

CC7 1 : 60 

CC72 : 

CC72: 

CC72 : 

CC72 : 0001 

CC72 : 

CC72 : CC72 

CC72 : CC72 

CC72 : A0 00 
CC74 : A5 4B 
CC76 : 48 

CC77 : D0 03 CC7C 

CC79 : 4C 09 CD 
CC7C: 

CC7C: 

CC7C: 

CC7C: 

CC7C : CC7C 

CC7C : AD EC C0 
CC7F : 1 0 FB CC7C 

CC8 1 : 85 59 
CC83 : 

CC83 : 

CC83 : 

CC83 : 4A 
CC84 : 4A 
CC85 : 4 A 
CC86 : 29 0F 
CC88 : AA 
CC89 : A5 59 
CC8B : 29 07 
CC8D : 85 59 
CC8F : 

CC8F : 

CC8F : AD EC C0 
CC92 : 1 0 FB CC8F 
CC94 : 5D 9D CA 
CC97 : 91 56 
CC99 : 45 40 
CC9B : 85 40 
CC9D : C8 
CC9E: 

CC9E: 

CC9E : 

CC9E : 

CC9E : D0 02 CCA2 
CCA0 : E6 57 
CCA2 : 

CCA2 : 

CCA2 : 

CCA2 : AD EC C0 
CCA5 : 1 0 FB CCA2 
CCA7 : 5D AD CA 
CCAA : 9 1 56 
CCAC : 45 40 
CCAE : 85 40 
CCB0 : C8 
CCB1 : 

CCB1: 

CCB1 : 

CCB 1 : AD EC C0 
CCB4 : 1 0 FB CCB 1 
CCB6 : 5D BD CA 
CCB9 : 9 1 56 
CCBB : 45 40 
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CCBD : 85 40 61 sta checksum 

CCBF : C8 62 lny 

CCC0: 63 • 

CCC0: 64 • Now the fourth byte 

CCC0 • 65 * 

CCC0iAD EC C0 66 Ida 16clr*The0ff 

CCC3 : 1 0 FB CCC0 67 bpl «-3 ;Back 1 Instruction 

CCC5:5D CD CA 68 eor shift4,x ;Recombine the MSB with data 

CCC8 : 9 1 56 69 sta (buffer2),y ;Store it away 

CCCA:45 40 70 eor checksum ;Add it to the checksum 

CCCC:8S 40 71 sta checksum 

CCCE : C8 72 lny 

CCCF: 73 * 

CCCF : 74 • The first Y turn over occurs at this point in the loop. Update 

CCCF: 75 • the buffer pointer if it occurred. 

CCCF: 76 • 


CCCF : D0 

02 

CCD3 

77 



bne 

*♦4 


CCD1 :E6 

57 


78 



i nc 

buf fer2* 1 


CCD3: 



79 

• 





CCD3 : A6 

59 


80 



ldx 

t emp 

;Now we need the other index 

CCD5 : 



81 

• 





CCD5: 



82 

* Now 

the 

fifth 

byte 


CCD5: 



83 

• 





CCDS : AD 

EC 

C0 

84 



Ida 

16c 1 r ♦TheOf f 


CCDS : 10 

FB 

CCDS 

85 



bpl 

•-3 

{Back 1 instruction 

CCDA : 5D 

AD 

CA 

86 



eor 

s h i f 1 2 , x 

{Recombine the MSB with data 

CCDD : 9 1 

56 


87 



sta 

(buf fer2) ,y 

{Store it away 

CCDF : 45 

40 


88 



eor 

check sum 

{Add it to the checksum 

CCE 1 : 85 

40 


89 



sta 

checksum 


CCE3 : C8 



90 



i ny 



CCE4 : 



91 

# 





CCE4 : 



92 

• Now 

the 

sixth 

byte 


CCE4: 



93 

• 





CCE4 : AD 

EC 

C0 

94 



Ida 

16clr ♦TheOf f 


CCE7 : 10 

FB 

CCE4 

95 



bpl 

•-3 

{Back 1 instruction 

CCE9 : 5D 

BD 

CA 

96 



eor 

shi f t3 , x 

{Recombine the MSB with data 

CCEC : 91 

56 


97 



sta 

(buf f er2) , y 

{Store it away 

CCEE : 45 

40 


98 



eor 

checksum 

{Add it to the checksum 

CCF0 : 85 

40 


99 



sta 

check sum 


CCF2 : C8 



100 



1 ny 



CCF3 : 



101 

• 





CCF3 : 



102 

# And , 

i f 1 1 

na 1 ly , 

the seventh byte 

CCF3 : 



103 

* 





CCF3 : AD 

EC 

C0 

104 



Ida 

16clr*The0ff 


CCF6: 10 

FB 

CCF3 

105 



bpl 

•-3 

{Back 1 instruction 

CCF8 : 5D 

CD 

CA 

106 



eor 

shi f t4 , x 

{Recombine the MSB with data 

CCFB:91 

56 


107 



sta 

(buf fer2) ,y 

{Store it away 

CCFD : 45 

40 


108 



eor 

checksum 

{Add it to the checksum 

CCFF : 85 

40 


109 



sta 

checksum 


CD0 1 :C8 



110 



i ny 



CD02: 



111 

• 





CD02 : 



112 

• Now 

see 

if thl 

s is the last 

group of seven to receive 

CD02: 



113 

• 





CD02 : C6 

4B 


1 14 



dec 

grp7ctr 


CD04 : F0 

03 

CD09 

115 



beq 

done5 

;Go to get the checksum etc 

CD06 : 4C 

7C 

CC 

116 



jmp 

s tar t3S 

{Another topblts ... 

CD09 : 



117 

• 





CD09: 



1 18 

• Get 

and 

reconstruct the checksum 

CD09 : 



1 19 

• 





CD09 : 


CD09 

120 

done5 


equ 

• 


CD09 : AD 

EC 

C0 

121 



1 da 

16c 1 r *The0f f 


CD0C : 10 

FB 

CD09 

122 



bp 1 

•-3 


CD0E : 85 

59 


123 



sta 

temp 

{1 cG 1 c4 1 c2 1 c0 

CD10 : 



124 






CD 1 0 : 68 



125 



P la 


{Restore groups of 7 counter 

CD1 1 : 85 

4B 


126 



sta 

gr p7c t r 


CD1 3 : AD 

EC 

C0 

127 



Ida 

16c 1 r *The0f f 

{1 c7 1 c5 1 c3 1 cl 

CD16: 10 

FB 

CD13 

128 



bpl 

•-3 


CD18 : 38 



129 



sec 



CD19 : 2A 



130 



rol 

a 

;c7 1 cS 1 c3 1 cl 1 

CD1A:2S 

59 


131 



and 

temp 

;c7 c6 cS c4 c3 c2 cl c0 


cn 

Cr> 
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CD 1 C : 45 40 
CD1E : 

CD1E: 

CD1E: 

CD 1 E : AC EC C0 
CD2 1:10 FB CD1E 
CD23: 

CD23 : C 0 C8 

CD25 : D0 1C CD43 

CD27 : 

CD27 : 

CD27 : 

CD27 : 

CD27 : A6 4C 

CD29 : F 0 08 CD33 

CD2B: A0 00 

CD2D : 5 1 54 

CD2F : C8 

CD30 : CA 

CD3 1 : D0 FA CD2D 
CD33: 

CD33 : 

CD33: 

CD33: CD33 

CD33 : AA 

CD34 : D0 11 CD47 
CD36 : 

CD36 : 

CD36 : 

CD36 : CD36 

CD36 : AD ED C0 
CD39 : AD EE C0 
CD3C : 30 FB CD39 
CD3E : 

CD3E: 

CD3E : 

CD3E : AD E0 C0 
CD4 1 : 

CD4 1 : 18 
CD42 : 60 
CD43: 

CD43 : A9 20 

CD45 : D0 02 CD49 

CD47 : A9 10 

CD49 : 38 

CD4 A : 60 

CD4B : 

CD4B: 

CD4B : 

CD4B: 


132 eor checksum ;When we're done, should be zero 

133 • 

134 • Get the packet end mark. Is it correct? 

135 • 

136 r dha5 ldy 16clr«The0ff {Preserve A 

137 bpl rdhaS 

138 * 

139 cpy 'packetend 

140 bne npenderr5 

141 • 

142 * Didn't have time before to checksum oddbytes. Do it now 

143 * A still has the partial checksum 

144 • 

145 ldx oddbytes 

146 beq lcbt 15 

147 ldy #0 

148 Icbt5 eor (buffer), y 

149 iny 

150 dex 

151 bne icbt5 

152 • 

153 • Okay, checksum oughta be zero. If not, checksum error. 

154 • 

155 icbt15 equ • 

156 tax 

157 bne cserror5 

158 • 

159 • Wait for /BSY to go low 

160 • 

161 lstbsywait5 equ * 

162 Ida 16set *TheOf f 

163 r dh45 Ida 17clr*The0ff 

164 bmi rdh45 

165 • 

166 * Got the bytes, now acknowledge their reclept 

167 • 

168 Ida r eqc 1 r ♦TheOf f {Lower REQ 

169 • 

170 clc 

171 rts 

172 * 

173 npenderr5 Ida 'nopackend 

174 bne gserrorS 

175 cserrorS Ida *csumerr 

176 gserrorS sec 

177 rts 

178 • 

68 fin 

69 • 

70 Include pc. main 
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CD7D : CD7D 

CD7D : A5 43 

CD7F : 2A 

CD80 : 08 

CD8 1 :2A 

CD82 : 2A 

CD83 : 28 

CD84 : 2A 

CD85 : 29 03 

CD87 : 49 02 

CD89 : C0 04 

CD8B : B0 02 CD8F 

CD8D : 49 02 

CD8F : AA 

CD90 :E8 

CD9 1 : 86 43 

CD93 : 

CD93: 

CD93 : 

CD93 : 

CD93 : B9 73 04 
CD96 : 1 0 03 CD9B 
CD98 : 4C 3F CE 
CD9B: 

CD9B: 

CD9B: 

CD9B : CD9B 

CD9B : B9 F3 05 
CD9E : 85 54 
CDA0 : B9 73 06 
CDA3 : 85 55 
CDA5 : 

CDA5 : 

CDA5 : 

CDA5 : A0 01 
CDA7 : B 1 54 
CDA9 : 85 42 
CDAB : C8 
CDAC : B 1 54 
CDAE: AA 
CDAF : C8 
CDB0 : B 1 54 
CDB2 : 85 55 
CDB4 : 86 54 
CDB6 : 

CDB6 : 

CDB6: 

CDB6: 

CDB6 : A9 01 

CDB8 : A6 42 

CDBA : E0 0A 

CDBC : 90 03 CDC1 

CDBE : 4C 0F CF 

CDC1 : CDC1 

CDC 1 : A0 00 
CDC3 : B 1 54 
CDC5 : 85 5A 
CDC7 : 

CDC7 : 

CDC7 : 

CDC7 : CDC7 

CDC7 : A0 08 
CDC9: CDC9 

CDC9 : B 1 54 
CDCB : 99 42 00 
CDCE : 88 

CDCF : D0 F8 CDC9 
CDD1 : 

CDD1 : 

CDD1 : 

CDD1 : 


76543210 746 specify unit 
65432 1 0X C<-7 
Save drive num 
543210X7 C<-6 
43210X76 C6 is grp of 2) 

C<-7 

3210X767 

ProDOS only installs up to 4 

000000/67; 6 was /grpoftwo 

If in slot 1,2, or3 reverse grps of 


Now if this is through the ML I xface, gotta copy stuff into the 
send buffer from the parameter list. 

1 da ProF lag , y 

bpl darnit 
Jmp sklpcopy 

Get the address of the in-line parameter table 


1 da SHTempX , y 
sta buffer 
Ida SHTempY.y 
sta buffer* 1 


;Get back the low part buff addr 
; and the hi part 


Now pull out the command code, and the address of the 
parameters . 


1 19 

1 dy 

• \ 

{Stacked address is EA-1 

120 

Ida 

(buffer) ,y 


121 

5 ta 

cmdcode 

;Nice 

122 

123 

i ny 
Ida 

(buffer) ,y 

{Get lo part of parmlist addn 

124 

tax 


{Save it 

125 

126 

i ny 

1 da 

(buffer) ,y 

{Get hi part 

127 

sta 

buffer* 1 

128 

s tx 

buffer 



Now buffer points to parmlist 
Check command type, and pidgeonhole the parmlist length 


Ida 'BadCmd 
ldx cmdcode 
cpx * $ A 

bit noeh 

Errorhitch Jmp Error 

noeh equ • 

ldy #0 
Ida (buffer), 
sta Unit 

• Now copy the bytes 


; Only valid codes are 0-9 
;»> at least he got that right 
;Gee, maybe we should promote this 
guy. . . 

;Set for indct compare 
;Get • of parms? 


145 okaycnt 

equ 

• 

146 

ldy 

# >cmdlength- 

147 copyloop 

equ 

• 

148 

1 da 

(buffer) , y 

149 

s ta 

cmdcode , y 

150 

151 

152 • 

dey 

bne 

copyloop 


153 • Okay. The caller of the PC 

154 • with a unit number of $00, 

these 

155 • and do what is appropriate. 


;Always copy the maximum 

;Pull it out of their hat 
;Stuff it into mine 

; Copy 'em all 

could be making one of three calls 
Control, Init or Status. Check for 
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CE2B : A9 C0 
CE2D : 8D F9 05 
CE30 : A9 0F 
CE32 : 0C 9A C0 
CE35 : D0 05 CE3C 
CE37 : 

CE37: CE37 

CE37 : A9 01 
CE39 : 1C 9A C0 
CE3C : 4C EC CD 
CE3F : 

CE3F : 

CE3F : 

CE3F : 

CE3F : 

CE3F : 

CE3F : 

CE3F : CE3F 

CE3F : A9 28 

CE4 1 : A4 58 

CE43 : BE F9 06 

CE46 : E4 43 

CE48 : 90 DB CE25 

CE4A : 

CE4A : 

CE4A : 

CE4A : A9 09 
CE4C : 85 4D 
CE4E : A9 00 
CE50 : 85 4E 
CE52 : 85 55 
CE54 : A9 42 
CE56 : 85 54 
CE58 : 

CE58 : 

CE58 : 

CE58 : A6 58 
CE5A : BD 73 04 
CE5D : 1 0 13 CE72 
CE5F : 

CE5F : 

CE5F : 

CE5F : A6 42 
CE6 1 : BD 86 CF 
CE64 : 29 7F 
CE66 : 85 5A 
CE68 : 

CE68 : 

CE68: 

CE68 : A9 00 
CE6A : 85 48 
CE6C : 

CE6C : 

CE6C: 

CE6C : A5 42 

CE6E : D0 02 CE72 

CE70 : 

CE70 : 85 46 
CE72 : 

CE72 : 

CE72 : 

CE72 : CE72 

CE72 : A5 5A 

CE74 : A6 43 

CE76 : 86 5A 

CE78 : 85 43 

CE7A : 

CE7A : A9 80 
CE7C : 85 5B 
CE7E : 

CE7E : 20 8A CA 


228 Ida '$C0 

229 sta <5F9 

230 Ida '$0F 

231 tsb IC09A 

232 bne aokayhltch 

233 * 

234 disabint equ * 

235 Ida #<01 

236 trb <C09A 

237 aokayhitch Jmp AOkay 

238 • 

239 else 

244 fin 

245 • 

246 • Okay, everything's all groovy. ProDOS re-enters here. 

247 • Check Unit number to be sure there is a corresponding device 

248 • 

249 skipcopy equ • 

250 Ida #NoDrlve ;Anticpate bad unit number 

251 ldy slot 

252 ldx NumDevices.y 

253 cpx CMDUnlt 

254 bit ErrorHitch2 ;Safe- If C clr then Z is clr 

255 • 

256 * Set buffer and bytecount in antlcpation of the inevitable 

SendPac k . 

257 • 

258 Ida #>cmdlength 

259 sta bytecountl 

260 Ida #<cmdlength 

261 sta bytecounth 

262 sta buffer+1 

263 Ida #>cmdcode 

264 sta buffer 

265 • 

266 * If it's a PC call, omit the next two steps 

267 * 

268 ldx Slot 

269 Ida ProFlag.x ;Is it a call from ProDOS? 

270 bpl notstat ;■> Statcode already set... 

271 • 

272 • Need to generate a parameter count for a ProDOS call 

273 * 

274 ldx CMDCode 

275 Ida ParmCTab , x 

276 and #<7F 

277 sta Unit 

278 • 

279 • ProDOS always needs the highest blockno byte zeroed 

280 • 

281 Ida #0 

282 sta CMDBlockS 

283 • 

284 • If this is a ProDOS status call, set stat code to zero 

285 • 

286 Ida CMDCode 

287 bne notstat ;-> Not status so forget it 

288 * 1 da #5CDevl ceStat ;A is already zero 

289 sta CMDSCode ;Store in command table 

290 • 

291 • Okay, finally send over the damn command 

292 • 

293 notstat equ • 

294 Ida Unit 

295 ldx CmdPCount ;Swap the Parmcount & unit# 

296 stx Unit 

297 sta CMDPCount ;Now they're correct 

298 • 

299 Ida #cmdmar k 

300 sta UPacketType 

301 • 

302 Jar ClrPhases ;Bring all phases 
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4^ 

CJi 


OO 


07 PC. MAIN 
CE81 : 

CE81 : 20 EC CA 
CE84 : B0 46 CECC 
CE86 : 

CE86 : 

CE86 : 

CE86 : AS 44 
CE88 : 85 54 
CE8A : A5 45 
CE8C : 85 55 
CE8E : 

CE8E : 



CE99: 

CE99 : A0 01 
CE9B: B1 54 
CE9D: AA 
CE9E : 88 
CE9F : B1 54 
CEA 1 : 48 
CEA2 : 18 
CEA3 : A9 02 
CEA5 :65 54 
CEA7 : 85 54 
CEA9 : 68 

CEAA : 90 13 CEBF 
CEAC : E6 55 
CEAE : 4C BF CE 
CEB1 : 

CEB1 : CEB1 

CEB1 : E0 02 
CEB3 : D0 06 CEBB 
CEB5 : 

CEB5 : 

CEB5 : 

CEB5 : 

CEB5 : A9 00 

CEB7 : A2 02 

CEB9 : D0 04 CEBF 

CEBB: 

CEBB: 

CEBB: 

CEBB: 

CEBB: CEBB 

CEBB : A6 47 
CEBD : A5 46 
CEBF: 

CEBF: CEBF 

CEBF : 86 4E 
CEC 1 : 85 4D 
CEC3: 

CEC3: A9 82 
CEC5: 85 5B 
CEC7 : 

CEC7 : 20 DD CA 
CECA : 90 04 CED0 
CECC: CECC 

CECC : A9 06 
CECE : D0 3F CF0F 
CED0 : 



368 Jar SendData 

369 bcc noxtraaend 

370 behitch equ • 

371 Ida #BusErr ;Thla ia the bua error hitch 

372 bne Error 

373 • 
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CED0 : 

CED0 : 

CED0 : 

CED0 : 

CED0 : CED0 

CED0 : A4 58 

CED2 : B9 73 04 

CEDS : 10 0C CEE3 

CED7 : A5 42 

CED9 : D0 08 CEE3 

CEDB: 

CEDB : A9 45 
CEDD: A2 00 
CEDF : 85 54 
CEE 1 : 86 55 
CEE3: 

CEE3 : 

CEE3: 

CEE3 : CEE3 

CEE3 : 20 33 CB 

CEE6 : B0 E4 CECC 
CEE8 : 

CEE8: 

CEE8: 

CEE8 : 20 50 CC 
CEEB : 20 F2 CF 
CEEE : 

CEEE : 

CEEE: 

CEEE: 

CEEE: 

CEEE : A5 42 

CEF0 : D0 IB CF0D 

CEF2 : A6 58 

CEF4 : BD 73 04 

CEF7 : 1 0 14 CF0D 

CEF9: 

CEF9 : A5 46 

CEFB : 9D F3 05 
CEFE : A5 47 
CF00 :9D 73 06 
CF03 : 

CF03 : A5 45 

CF05 : 29 10 

CF07 : D0 04 CF0D 

CF09 : A9 2F 

CF0B : D0 02 CF0F 

CF0D: 

CF0D: 

CF0D: 

CF0D: 

CF0D: 

CF0D: 

CF0D: 

CF0D: 

CF0D: 

CF0D: CF0D 

CF0D : A5 4D 

CF0F : CF0F 

CF0F : A4 58 

CF 1 1 : 99 F3 04 

CF 1 4 : AA 

CF 1 5 : F0 1 A CF31 

CF 1 7 : 

CF 1 7 : BE 73 04 
CF 1 A : 10 15 CF3 1 
CF1C: 

CF 1 C : A2 00 

CF 1 E : C9 40 

CF20 : B0 0E CF30 

CF22 : 


• On ProDOS atatus call, we've got to point the buffer pointe 

• correctly to zero page... it'a the only case apecial case 

• Con Write, Format and Control no data comes back). 

noxtrasend equ • 

ldy Slot 
Ida ProFlag.y 
bpl getresu Its 

Ida cmdcode 
bne getresults 


Ida *>CMDBuf f erh 
ldx *<CMDBuf ferh 
ate buffer 
atx buffer*1 


5 Want status in these four 


Please to be calling ReceivePack 


getresults equ • 

Jar RecPack 


bca behitch 


;Get status byte (maybe read data 
too) 


• Figure how many bytes were sent and put that in X,Y temps 


jsr Rcvcount 
Jar squirrel 


; Do the t imes 7 . . . 

; Store away count in SHTEMPs 


• For the ProDOS status call, we've got to look at the status byte 

• returned and return a DIP error if appropriate. 

• Also overwrite the X,Y temps with • blocks if this is a ProDOS 
Stat call. 


CMDCode 

noerror 

Slot 

ProFlag , x 
noerror 


CMDBufferh 

'SVMaskl 

noerror 

'OffLine 

Error 


;Is it a ProDOS status call 


•This'll get loaded into the XY reqs 
later 3 


;Check status byte 


Now it's time to think about returning to the caller 
Remember that ProDOS doesn't want to know about soft errors, 
only fatal ones. If this is a ProDOS call, and the soft error 
bit in the statbyte is set, there IS NO error (statbyte is 
cleared) . 

Also, ProDOS wants only I/O, Write Protect, No Device, Offline. 
If any other hard error comes from the device on a ProDOS call, 
map it to an I/O Error. (Gross me out.) 


ldy Slot 
sta Retry, Y 
tax 

beq sa2 


;Need access to screenholes 
;Keep unadulterated error in shole 
;Set the Z flag 
; Spec i a 1 case the zero 

;Set N to ProDOS call or not 
;If PC call, no mapping occurs 


441 

442 

443 

444 


ldx *0 ;Assume a soft error 

cmp 'X01000000 ;Soft error check 

bge storeaway ; I f «40 or bigger, map to zero 
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CF 22 : A2 27 

CF24 : C9 2B 

CF26:F0 09 CF31 

CF28 : C9 28 

CF2A : F0 05 CF31 

CF2C : C9 2F 

CF2E : F0 01 CF31 

CF30: 

CF30 : CF30 

CF30 : 8A 

CF3 1 : CF3 1 

CF3 1 : A4 58 


CF33 : 99 73 05 
CF3G : 

CF36 : 

CF36 : 

CF36 : 

CF36: 

CF36 : 

CF36 : 

CF36 : 

CF36: 

CF36 : 0001 

CF36 : AD E8 C0 
CF39 : 2C ED C0 
CF3C : A9 2B 
CF3E : 8D EF C0 
CF41:EA 
CF42 : EA 
CF43 : EA 
CF44 : EA 

CF45 : CF45 

CF45 : AD EE C0 
CF48 : 29 20 
CF4A:D0 F9 CF45 
CF4C : A0 00 
CF4E:A2 60 
CF50 : 20 IF CC 
CF53 : AD EC C0 
CF56 : AD E2 C0 
CF59 : AD E6 C0 
CFSC:A4 58 
CFSE: 

CFSE : 

CFSE: 

CF5E : 

CFSE: 

CFSE: 

CFSE: 

CF5E : A2 00 

CF60 : 68 

CF61 :95 40 

CF63 : E8 

CF64 : E0 1C 

CF66:90 F8 CF60 

CF68 : 

CF68 : 

CF68 : 

CF68 : 

CF68 : 28 
CF69 : B9 F3 05 
CF6C : AA 
CF6D : B9 73 05 
CF70 : 48 
CF7 1 : B9 73 06 
CF74 : A8 
CF7S: 18 
CF76 : 68 

CF77 : F0 01 CF7A 
CF79: 38 

CF7A : CF7A 


Protocol Converter / CBus Driver 


445 ldx 

446 cmp 

447 beq 

448 cmp 

449 beq 

450 cmp 

451 beq 

452 * 

453 storeaway equ 

454 txa 

455 aa2 equ 

456 lay 

457 ata 


' I OEr ror 

'WriteProt 

aa2 

'NoDr i ve 
sa2 

'OffLine 

SA2 


Slot 

SHTemp 1 , y 
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ntlclpate ProDOS I/O e 
return Write Protect 


;0K to return Drive disconnected 


;Keep In acreenhole 


If thia la the //c version, we need to reset the IWM to ita 
former diak // atate. Thia la done by aettlng the mode 
regiater 

to a little known (and leas documented) mode which speeds up 
internal motor timeout. When the motor enable has timed out, 
mode can be set back to zero. Thia method ia necessary because 
if the timer ia enabled within the timeout period, the motor on 
Rev A IWM popa on for the full timeout period (since mode 
changea 

are diaabled when the motor ia on. I know, it'a bizzarre. 

Blame Mac. 


467 

468 

469 

470 

471 

472 

473 

474 

475 

476 waltoff 

477 


monclr**60 {Motor off 

16set**60 ;Into mode reg access mode 

'•2B {This ia the magic "apeed up" value 

17aet+*60 ; Throw into mode register 

;You're supposed to wait a while 


'*60 

Set I WMode 
16c 1 r + *60 
ca1clr+*60 
latrbclr* *60 
Slot 


;Now set the reg back to *00 
{IWM'a in slot 6 


; Need Slot in Y 


restore our zero page area. 


502 • 

503 • We're into 

504 * A and set th 

505 • 

506 pip 

507 Ida 

508 tax 

509 Ida 

510 pha 

511 Ida 

512 tay 

513 clc 

514 p 1 a 

515 beq 

516 sec 

517 finalakip equ 


into the atretch! Restore interrupt mask, load X, Y, and 
et the carry if the error byte la non-zero. 


;Restore interrupt flag 
;Get X value 

;Grab the error result code 

;Pull out the Y value 
; No more access to acreenholes 
{Anticipate zero result code 
{Pull back result code 
{Return with carry clear 
{Some type of error 


Cn 

CO 


07 PC. MAIN 


Protocol Converter / CBus Driver 
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CF7A : 518 • 

CF7A : 0001 519 do IIc*R0M 

CF7A:08 520 php {Save carry and Z flag 

CF7B:2C 78 04 521 bit ProFlag*5 {Ick - ProFlag is fixed in //c 

CF7E:70 04 CF84 522 bvs ickl {If bit 6-1, then return to alt ROM 

CF80:28 523 pip {Vclr so return across ROM bank bdy 

CF8 1 : 4C 84 C7 524 Imp SWRTS2 

CF84 : CF84 525 ickl equ * 

CF84 : 28 526 pip 

CF85:60 527 rts {Flags set correctly again 

CF86 : 528 else 

CF86 : 530 fin 

CF86 : 531 • 

CF86 : 532 • 

CF86: CF86 533 parmctab equ • 

CF86 : 03 534 dfb X00000011 {Status: 3 parma/no data send 

CF87:03 535 dfb X00000011 {Read: 3 parma/no data send 

CF88:83 536 dfb X10000011 {Write: 3 parma/data send 

CF89:01 537 dfb X00000001 {Format: 1 parm /no data send 

CF8A:83 538 dfb X10000011 {Control: 3 parma/data send 

CF8B:01 539 dfb X00000001 {Init: 1 parm /no data send 

CF8C:01 540 dfb X00000001 {Open: 1 parm /no data send 

CF8D : 0 1 541 dfb X00000001 {Close: 1 parm /no data send 

CF8E:03 542 dfb X00000011 {CharRead: 3 parma/data send 

CF8F:83 543 dfb X10000011 {CharWrite: 3 parma/data send 

CF90 : 544 • 

CF90 : 545 • 



ID Assignment Cycle 
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07 PC. MAIN 

OS 

CF90 : 

CF90 : CF90 

CF90 : 48 

CF91 : 20 60 CA 

CF94 : 68 

CF95 : AA 

CF96 : 

CF96 : 

CF96 : 

CF96 : A5 42 
CF98 : 48 
CF99 : A5 43 
CF9B : 48 
CF9C : A5 46 
CF9E : 48 
CF9F :86 46 
CFA1 : 

CFA 1 : 

CFA1 : 

CFA1 : A9 05 
CF A3 : 85 42 
CFA5:A9 00 
CFA7 :85 5A 
CFA9:A9 02 
CF AB : 85 43 
CFAD: 

CFAD: 

CFAD: 

CFAD: A9 42 
CFAF : 85 54 
CFB 1 : A9 00 
CFB3 : 85 55 
CFB5 : A9 80 
CFB7 : 85 SB 
CFB9: 

CFB9 : 20 8A CA 
CFBC : 

CFBC: 

CFBC: 

CFBC: CFBC 

CFBC : E6 5A 

CFBE : A9 09 

CFC0 : 85 4D 

CFC2 : A9 00 

CFC4 : 85 4E 

CFC6 : 

CFC6 : 20 86 C8 
CFC9 : 90 05 CFD0 
CFCB : 

CFCB : C6 5A 
CFCD : 4C D7 CF 
CFD0 : 

CFD0 : 20 E6 C9 
CFD3 : A5 4D 
CFD5:F0 ES CFBC 
CFD7: 

CFD7 : 

CFD7 : 

CFD7 : A5 SA 
CFD9 : A4 58 
CFDB : 99 F9 06 
CFDE : 

CFDE : 

CFDE: 

CFDE : 68 
CFDF : 85 46 
CFE 1 : 68 
CFE2 : 85 43 
CFE4 : 68 
CFE5 : 85 42 
CFE7: 



CMDCode 


07 PC. MAIN 


ID Assignment Cycle 
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CFE7 : 0001 

CFE7 : 

CFE7 : 60 
CFE8 : 

CFE8 : 

CFE8 : 0001 

CFE8 : CFE8 

CFE8 : 

CFE8 : 

CFE8 : 

CFE8 : A2 05 
CFEA : A9 40 
CFEC : 9D 73 04 
CFEF : 4C 55 CD 
CFF2 : 

CFF2 : 

CFF2 : 

CFF2 : CFF2 

CFF2 : A6 58 

CFF4 : 9D F3 05 

CFF7 : 98 

CFF8 : 9D 73 06 

CFFB : 60 

CFFC : 

CFFC : 

CFFC: 

CFFC: 0001 

CFFC: 

CFFC: 

CFFC: CFFC 

CFFC: 0001 

CFFC: 

CFFC: 


618 ifeq IIc A ROM 

627 fin 

628 r t s 

629 * 

630 • 

631 do lie 

632 AppleTal kEntry equ * 

634 • This is an entry for the 

635 • 

636 ldx #5 

637 Ida 'X01000000 

638 sta ProF lag , x 

639 Jmp atentry 

640 fin 

641 • 

642 • 

643 squirrel equ • 

644 ldx Slot 

645 sta SHTempX.x 

646 tya 

647 sta SHTempY.x 

648 rts 

649 • 

650 • 

71 • 

72 ifeq IIc A R0M 

74 fin 

75 • 

76 zzzzz equ * 

77 ifeq IIc A R0M 

82 fin 

83 * 


//c 


AppleTalk 

PC call & 
Just like 


stump . 

return to alt ROM 
norma 1 


ROM, pad bytes 
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SORTED BY SYMBOL 
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C90E ACHE 1 CD8F ALLSET 1 

CE3C AOKAYH I TCH CDEC AOKAY 

CD5S ATENTRY ?FABA AUTOSCAN 

? 4E AUXTYPE ? 2D BADBLOCK 

21 BADCTL 04 BADPCNT 

C52F BC 1 CECC BEHITCH 

00 11 BMSGLEN C52 1 BOOTC 

CSS2 BOOTFAIL CSSF BOOTMSG 

32 BSYTOI 0 A BSYT02 

CE27 BUNIT 06 BUSERR 

4D BYTECOUNT 4E BYTECOUNTH 

C082 CA1CLR C083 CA1SET 

CC2C CAREFUL C8A5 CHA I NUNBSY 

CFFF CLEAR I OROMS CA8A CLRPHASES 

48 CMDBLOCKS 7 46 CMDBLOCK 

44 CMDBUFFER 42 CMDCODE 

80 CMDMARK 43 CMDPCOUNT 

? 4 A CMDSPARE2 43 CMDUNIT 

04 CONTROLCMD CDC9 COPYLOOP 

10 CSUMERR ? 25 CV 

C999 DATDONE C9C3 DBERROR 

CE37 DISABINT CBSS DIV7TAB 

CB8E DIVIDE3 CB95 DIVIDE4 

CD09 D0NE5 CE2B ENABINT 

CA80 ENABLECHAIN CD4B ENTRY 

CE25 ERRORH I TCH2 CF7A FINALSKIP 

CA47 GOBI 7C9E6 GRABSTATUS 

CBE8 GTBOB ? 51 HOSTID 

CF84 I CK 1 01 lie 

C080 IWM 07 IWMMODE 

C08E L7CLR C08F L7SET 

00 LOC0 ? 01 LOCI 

C087 LSTRBSET C9E3 MARKERR 

CFD0 MDEV2 C50D ML I ENTRY 

C089 MONSET CSS4 MORCHRS 

4D NEXT 1 4E NEXT2 

4F NEXT3 51 NEXTS 

CDFF N I N 1 01 NOANSWER 

28 NODRIVE CDC 1 NOEH 

? 02 NOMARK 20 NOPACKEND 

CE72 NOTSTAT CEBB NOWBLOCK 

06F9 NUMDEVICES 4C ODDBYTES 

CA7C ONEMS1 CA7A ONEMS 

CF86 PARMCTAB C9BE PATCH 1 

00 PCID2 BF PDIDBYTE 

? 52 POINTER 00 POWERRESET 

C50A PRODOSENTRY 0473 PROFLAG 

05 RC2 C583 RCODE 

C9F8 RDH 1 CA02 RDH2 

?CA0E RDH5 CD1E RDHA5 

CB33 RECPACK C080 REQCLR 

C576 RESET 0573 RETRY2 

? 4F RPACKETTYPE CB3A RPK 1 

CF60 RZP CF3 1 SA2 

? 01 SCGETDCB ? 03 SCGETDEV I NFO 

? 02 SCRETNLSTAT C9CF SD10 

CAEB SDOUBT CEBF SECONDSEND 

CADD SENDDATA C886 SENDONEPACK 

CC1F SETIWMODE ?FE89 SETKBD 

CA9D SHIFT1 CAAD SHIFT2 

0573 SHTEMP1 05F3 SHTEMPX 

C929 SKIP2 C963 SKIPS 

58 SLOT CC72 SLOTDEPRD 

C900 S0B3 ? 67 SOFTERROR 

CB32 SPILOUT CFF2 SQUIRREL 

->0100 STACK CA34 START0 

C903 START CA4E START2 

? 81 STATMARK IE STATMTO 

CC0B SUN 1 CC02 SUN2 

0778 SVBCH 06F8 SVBCL 

C784 SWRTS2 7C9D7 SYNCTAB 


7CD7D ALLSET 7CB04 ALTSENDPILE 

CFE8 APPLETALKENTRY CF90 ASSIGNID 

CB6 1 AUXPTRINC 56 AUXPTR 

01 BADCMD 7 22 BADCTLPARM 

11 BADUNIT 7E000 BASIC 

CD50 BENTRY CC28 BIZ 

7C514 B00TCASE5 C523 BOOTCODE 

07DB BOOTSCRN C570 BOOTTAB 

54 BUFFER 56 BUFFER2 

7 40 BUSHOG 7 08 BYTECMP 

4D BYTECOUNTL 7C500 C500ORG 

C084 CA2CLR C08S CA2SET 

40 CHECKSUM 7 24 CH 

47 CMDBLOCKH 46 CMDBLOCKL 

45 CMDBUFFERH 44 CMDBUFFERL 

09 CMDLENGTH 7C58A CMDLIST 

46 CMDSCODE 7 49 CMDSPARE 1 

C55D COMA 80 COMMRESET 

7FDED COUT CD47 CSERR0R5 

CD9B DARN IT 82 DATAMARK 

7CBE1 DETTOPBITS 7 50 DEVICEID 

CB9E DI VIDE 1 CBA7 DIVIDE 2 

CBB0 DIVIDE5 7CB64 DIVIDE7 

7C08A ENABLE 1 C08B ENABLE2 

CF0F ERROR CDBE ERRORHITCH 

7 03 FORMATCMD CEE3 GETRESULTS 

4B GRP7CTR CD49 GSERR0R5 

CD33 ICBT15 CD2D ICBT5 

05 INITCMD 27 IOERROR 

C08C L6CLR C08D L6SET 

7 68 LASTONE CBCF LASTPASS 

7CD36 LSTBSYWA I T5 C086 LSTRBCLR 

CE 1 8 MAYBECTRL CFD7 MDEV1 

CB5B M0D7TAB C088 MONCLR 

CFBC MORDEVICES 07F8 MSLOT 

50 NEXT4 4D NEXT 

52 NEXT6 53 NEXT7 

CB7B NOAUXPTR CEB1 NOCONTROL 

CF0D NOERROR 7 IF NOINT 

CD6E NOPLAY CDF 1 NOTINIT 

CED0 NOXTRASEND CD43 NPENDERRS 

2F OFFLINE 7CDC7 OKAYCNT 

C3 PACKETBEG C8 PACKETEND 

7 AS PBBVALUE 7 FF PBCVALUE 

CB4F PDIV7TAB CB52 PM0D7TAB 

C9D6 PREAMBLE 7CBB0 PRECHECK 

CD75 PZP 0BB8 RC 1 

4B RCVBUF CC50 RCVCOUNT 

CA 1 0 RDH3 CD39 RDH45 

01 READCMD C9E6 RECE I VEPACK 

C081 REQSET CA60 RESETCHAIN 

04F3 RETRY 01 ROM 

CB4E RPOUT C578 RST 1 

CB76 SAP 1 7 00 SCDEV I CESTAT 

0473 SCHOLES C99D SCM1 

C9B2 SD7 C9C9 SD9 

CA5 1 SEND80 CA53 SENDBYTE 

CAEC SENDPACK CB00 SENDPILE 

7FE93 SETVID CA9A SETXN0 

CABD SHIFT3 CACD SHIFT4 

0673 SHTEMPY C927 SKIP1 

C96S SKIP4 CE3F SKIPCOPY 

C8E8 SOB 1 C8F9 S0B2 

40 SOFT CB0D SPILE1 

C8AF SSB C8B2 SSD 

CA3C START 1 7CC72 START25 

CC7C START35 4D STATBYTE 

7 00 STATUSCMD CF30 STOREAWAY 

7CC00 SUN CC IE SUN3 

10 SVMASK1 C797 SWPROTO 

CC66 T71 CC6F T72 


07 SYMBOL TABLE 


SORTED BY SYMBOL 
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59 TBODD 59 TEMP 

CC59 TIMES7 41 TOPBITS 

71000 VERSION 7FC22 VTAB 

7 04 WASRESET 7C9E2 WASTE 1 2 

7C9DF WASTE 18 7C9DC WASTE32 

5B WPACKETTYPE 02 WRITECMD 

CBBC XOR1 7CBB9 X0R2 

CBCD XORS CA73 YMSWAIT 

7CFFC ZZZZZ 

*• SUCCESSFUL ASSEMBLY NO ERRORS 
•• ASSEMBLER CREATED ON 15-JAN-84 21: 
*• TOTAL LINES ASSEMBLED 3903 
•• FREE SPACE PAGE COUNT 70 


60 THEOFF 7C000 THEORG 

C899 UBSY1 5A UNIT 

CC3S WAITIWMOFF CF45 WA I TOFF 

C9E 1 WASTE 1 4 7C9E0 WASTE 16 

CC3E WIWM1 CC4B WIWM2 

CB64 WRITEPREP 2B WRITEPROT 

CBD5 X0R3 CBDC X0R4 

40 ZEROPAGE 1C ZPSIZE 



SOURCE FILE '01 ->APTALK.2C 
INCLUDE FILE '02 - >/APPLETALK2C . D 1 /APTALK . VAR I ABLS 
INCLUDE FILE '03 -> /APPLETALK2C . D2/ APTALK . C70 0 
INCLUDE FILE '04 -> /APPLETALK2C . D2/ APTALK . ROMSTUFF 
0000: 0001 1 GENERAL EQU 1 

0000: 0000 2 TWOCBOX EQU 0 


; no list/list general stuff 
;2CR0M stuff only/both ROM+box 



0000: 0002 22 X6502 ;Allow 65C02 opcodes!! 

0000: 23 MSB ON 

0000: 25 LST NOCYCLES 

0000: 26 INCLUDE /APPLETALK2C . D 1 /APTALK . VAR I ABLS 


02 APTALK. VARIABLS AppleTalk //c Variables. 
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0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 


0000 : 


0000 : 


0000 : 

0000 : 

0000 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 

0000 : 
0000 : 
0000 : 
0000 : 

0000 : 
0090 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 
0000 : 


0000 : 


0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 


0000 : 
0000 : 
0000 : 
0000 : 

0000 : 


3 • 

4 • 

5 • 

6 • 

7 • 

8 • 
9 • 

10 * 
11 * 
12 • 

13 • 

14 • 

15 • 


192 LST ON 


194 * Apple //c zero page used at boot and not restored. 
0008 196 ZP8 EQU $8 ;Used and not restored 

198 • AppleTalk //c Converter Box stuff 

200 • I N I TCMD EQU 1 ;Init command ' 

201 ‘READRCMD EQU 2 ;Read rest of pkt cmd ' 

202 • WR I TECMD EQU 3 ;Wrlte pkt command ' 

203 *STATCMD EQU 4 -.Status command ' 

204 • READPCMD EQU 5 ;Read protocol cmd ' 

0081 205 DIAGCMD EQU <81 ;Diag call command ' 

207 * The following table contains the only 

208 * valid CODESCMD's recognized by the 

209 • AppleTalk//c box when using the protocol 

210 • converter's STATUS command. 

212 * < 0 "Short status request 

213 • < 1 “Return DCB info 

214 • $2-NEWLINE info 
2 IS • <3-Return DIB 

0004 216 CMDCINIT EQU $4 

0005 217 CMDCSTATUS EQU <5 

0006 218 CMDCREADREST EQU <6 

0007 219 CMDCREADPROT EQU $7 

0008 220 CMDCDIAG EQU <8 

0009 221 CMDCREBOOT EQU <9 

000A 222 CMDCID1 EQU <A 

223 • <B-AppleTalk ID call 2 


225 * Protocol converter commands 

0000 227 PCSTATUSCMD EQU <0 ;Prot Conv status command 

228 • < 1 “Prot Conv readblk command 

229 * <2-Prot Conv wrlteblk command 

230 • $3-Prot Conv format command 

231 • <4 a Prot Conv control command 

232 • <5"Prot Conv inlt command 

233 • <6“Prot Conv open command 

234 • <7*Prot Conv close command 

235 • <8-Prot Conv read command 

0009 236 PCWRITECMD EQU <9 ;Prot Conv write command 


238 * RELVERNUM is the version number 

239 • for 65C02 RELease VERslon NUMber. 

240 * It must be kept updated as this product 

241 • Is updated. 

0000 243 RELVERNUM EQU 0 jRelease version '-0 


$4“AppleTalk Inlt command 
$5 a AppleTalk Status command 
<6 a AppleTalk Readrest cmd 
<7 a AppleTalk Readprot cmd 
$8 a AppleTalk Dlag command 
$9 a AppleTalk Reboot command 
<A-AppleTalk ID call 1 


AppleTalk //c Protocol Converter 
Variables 
by 

Fern Bachman 

Copyright Apple Computer, Inc. 1985 
All Rights Reserved. 



02 APTALK.VARIABLS AppleTalk //c Variables 
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0000: 245 • STATBYTE codes 


0000 

0081 

247 

CMDERROR 

equ 

$ 0 1 ♦ $80 

; Illegal Command Type 

0000 

0091 

248 

BADUNIT 

EQU 

$ 1 1 *$80 

;Bad unit number 

0000 

0 0 A 1 

249 

CODERROR 

equ 

$21 ♦ $80 

{Control or status code error 

0000 

00A2 

250 

BADPCNT 

EQU 

$22* $80 

;Bad pcount error 

0000 

00A8 

251 

NODEVCON 

EQU 

$28*$80 

;Dev to access not connected 

0000 


253 

• LSTNONBT 

indicates this 

device is the last 

0000 


254 

• 

o 

ne in the cha 

in and if it is also 

0000 


255 

• 

u 

nit number 1 

then it is not a 

0000 


256 

• 

b 

ootable device. 

0000 


258 

•LSTERRBT 

EQU $40*$80 ; Las t 

one in chain and bootable 

0000 

00C1 

259 

LSTNONBT 

EQU 

$41 *$80 

{Last one in chain/NOT bootab 

0000 


261 

* AppleTalk spe 

clfic error c 

odes for STATBYTE. 

0000 

00B1 

263 

NOPKTINBUF 

EQU 

$80 ♦ $30 *$0 1 

;No packets in buffer 

0000 

00B2 

264 

BUFFEROVER 

EQU 

$80*$30*$02 

{Buffer overflowed 

0000 

0 0B3 

265 

READPSTEND 

EQU 

$80 * $30 ♦ $03 

{Tried to read past end of pk 

0000 

00B4 

266 

NOUN I QUE I D 

EQU 

$80 ♦ $30 ♦ $04 

;No unique node addr found 

0000 

00B5 

267 

BYTEGTR603 

EQU 

$80*$30*$05 

bytes to send >603 

0000 

00B6 

268 

BYTELES003 

EQU 

$80*$30*$06 

bytes to send <3 

0000 

00B7 

269 

EXCESSDEFS 

EQU 

$80*$30*$07 

{Excessive deferrals 

0000 

00B8 

270 

TOOMANYCOL 

EQU 

$80 ♦ $30 *$08 

{Too many collisions 

0000 

00B9 

271 

ILLLAPTYPE 

EQU 

$80+$30+$09 

{Illegal lap type ( >$7F) 

0000 

00BA 

272 

NOTMYINTER 

EQU 

$80*$30*$0A 

{Not AppleTalks interrupt 

0000 

00BF 

273 

LASTPACKET 

EQU 

$80 ♦ $30 ♦ $0F 

{Last packet in series 

0000 

00C6 

274 

I D 1 

EQU 

'F 

;ID bytel for finding ApTalk 

0000 

0 0C2 

275 

ID2 

EQU 

'B 

;ID byte2 for finding ApTalk 

0000 

0003 

277 

PCOUNTC 

EQU 

$3 

{Control call PCOUNT 

0000 

0004 

278 

PCOUNTW 

EQU 

$4 

{Write call PCOUNT 

0000 

0002 

279 

PCOUNTI 

EQU 

$2 

; I ni t call PCOUNT 

0000 

0003 

280 

PCOUNTS0 . 3 

EQU 

$3 

{Status call PCOUNT for 0-3 

0000 

0006 

281 

PC0UNTS4 . B 

EQU 

$6 

{Status call PCOUNT for 4-B 

0000 : 


285 


LST 

ON 


0000: 


287 

• Apple //c zer 

o page usage 


0000: 

0039 

289 

KSWH 

EQU 

$39 

{Input hook hi byte 

0000: 


291 


DSECT 



00C0 

00C0 

292 


ORG 

$C0 


00C0 

00C0 

293 

ZP2CUSE 

EQU 

• 


00C0 

000 1 

294 

PARAMNUM 

DS 

1,0 

{Number of parameters 

00C1 

0001 

295 

NUMUNIT 

DS 

1,0 

{Unit number 

00C2 

0002 

296 

PTRBUFF 

DS 

2,0 

{Buffer pointer 

00C4 

0 0C4 

297 

CODECMDS 

EQU 

• 

{Command code 

0 0C4 

000 1 

298 

NUMLOWRITE 

DS 

1,0 

of bytes to write lo byte 

0 0C5 

00C5 

299 

BYTELONUM 

EQU 

• 

; * of bytes to read from box 

00C5 

0 0C5 

300 

NUMHIURITE 

EQU 

• 

of bytes to write hi byte 

00CS 

000 1 

301 

BYTEUSER 

DS 

1,0 

{User info byte 

00C6 

0 0C6 

302 

BYTEHINUM 

EQU 

• 

of bytes to read from box 

00C6 

000 1 

303 

TYPEWRITE 

DS 

1,0 

{Write type code 

00C7 

0002 

304 

TESTTMP 

DS 

2,0 

{Dlag read from address 

0 0C9 

000 1 

306 

ADDR0 

DS 

1.0 

{Used as temp and restored 

00CA 

0001 

307 

ADDR1 

DS 

1.0 

{Used as temp and restored 

0 0CB 

000B 

309 

ZP2CUSELEN 

EQU 

• -ZP2CUSE 

of bytes used in //c zpage 

0 0CB 

0002 

31 1 

BOOTIT 

DS 

2,0 

{Boot prog strt adr 


02 APTALK.VARIABLS AppleTalk //c Variables. 
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AppleTalk //c non zero page 


SOFTEV EQU 
APTALKUNIT EQU 
SCRNHOLE0 EQU 
SCRNHQLE 1 EQU 
SCRNH0LE2 EQU 
SCRNTMP0 EQU 
MSLDT EQU 

ALTROMSW EQU 
MA I NROMSW EQU 
ALTPRCNVENTRY 
INIT EQU 

HOME EQU 

SETNORM EQU 
SETKBD EQU 
SETVID EQU 


$3F2 
$7FE 
$47F 
$77F 
$7FF 
$478 
$7F8 
$C7D3 
$C784 
EQU $C883 
$FB2F 
$FC58 
$FE84 
$FE89 
$FE93 


eset vector 
nit * screen hole 
RIVERFLAG placed here 
rint drvr *>start-1 
rint drvr *<start-1 
emp use only 
ard slot * C$Cn) for 
witch to alt ROM vect 
witch to main ROM vec 
It ROM prot conv entr 
et in Text mode 
lear screen 
ormal char display 
eyboard is input devi 
ideo is output device 


0000: 29 LST ON 

■»- NEXT OBJECT FILE NAME IS APTALK.0 

C700: C700 30 ORG SC700 ;Cn00 page for //c goes here 

C70 0 : 31 INCLUDE /APPLETALK2C . D2/ APTALK . C700 



^ 03 APTALK.C700 

C700 : 

C700 : 

C700 : 

C700 : 

C700 : 

C70 0 : 

C70 0 : 

C700 : 

C700 : 

C700 : 

C700 : 

C700 : 

C70 0 : 



C700 
C700 
C700 
C700 
C700 
C70 0 
C70 0 
C700 
C70 0 
C700 
C700 
C700 
C700 
C700 
C700 
C70 0 
C700 
C700 
C700 
C700 
C700 
C70 0 
C700 
C70 0 
C700 
C70 0 
C700 
C700 
C700 
C700 
C700 
C700 
C70 0 


18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 


Entry at $C700 means that the user wants 
to Initialize the printer driver interface 
if one is loaded into main memory. 

To determine whether a driver is available 
or not we must perform the following steps; 

1. Determine which slot we are in to get *Cn. 

2. Test the 1st screen hole *3B8+*Cn to verify 
that it is *Cn (*Cn is the flag indicating 
a driver has been installed.) 

If a driver is not available the monitor ROM 
is mapped in and a JMP to the monitor RESET 
routine is executed. 

If a driver is available we pass data to is 
in the following form; 

Y - user Y 
X - user X 
A - user A 

P - Print character status 

V- 1 if inlt printer driver requested 
C-1 if input to printer 
C-0 if output to printer 
The driver can test the input/output hooks hi 
bytes to determine if the call is from BASIC or 
from machine language. If *37 is *Cn then the 
user did a PR'n. If *39 is *Cn then the user 
did a IN*n. If the hooks do not have *Cn as 
the high byte then the user entered from 
machine language. It is up to the driver to 
correctly observe this protocol. 


C700 : 2C 03 C7 52 BIT TOSETV 

C703 : C703 53 TOSETV EQU 

C703 : 70 IB C720 54 BVS BASICENT 

C705 : 55 ‘BASICINPUT EQU • 

C705 : 38 56 SEC 

C706 : 90 57 DFB *90 

C707 : 58 ‘BASICOUTPUT EQU * 

C707 : 18 59 CLC 

C708 : B8 60 CLV 

C709 : 50 15 C720 61 BVC BASICENT 


; B 1 1 here to set 'V' 

; BAS I C wants char if here 
; Identifier byte / 1 (*38) 

; BCC opcode 

; BAS I C sends char if here 
{Identifier byte *2 (*18) 
;Clear V if entered near here 
{Skip PASCAL protocol stuff 


C70B; 
C70B: 0 1 
C70C : 
C70C : 9B 
C70D : 1C 
C70E: 1C 
C70F : 1C 
C710: 1C 
C7 1 1 : 88 


63 ‘GENERIC EQU • 

64 DFB *01 

65 • DEVS I G EQU • 

66 DFB *9B 

67 DFB >PASERR 

68 DFB >PASERR 

69 DFB >PASERR 

70 DFB >PASERR 

71 DFB *88 


PASCAL generic sig byte 

9-bus card//B-Apple tech ID 

Offset to PASCAL err rtne 

Offset to PASCAL err rtne 

Offset to PASCAL err rtne 

Offset to PASCAL err rtne 

<>0 if no offsets follow 


03 APTALK . C700 


AppleTal k//c C700 Rtns 
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C712: 

C712: 

C712: 

C712: 

C712: 

C712: 

C712: 

C712: 

C712: 

C712 : 

C71 2 : 

C712: 

C712: 

C712: 

C712: 

C712: 

C712: 18 

C7 1 3 : 80 2A C73F 


C715: 

C715: 

C715: 

C715 : 

C715: C715 

C7 15 : 38 
C7 16 : 78 
C7 1 7 : A2 FF 
C7 19 : 9A 

C71 A : 80 26 C742 


C71C: C71C 

C7 1C : 38 
C71D: A2 03 
C7 1 F : 60 

C720 : 0000 

C720 : 0000 

C720 : C720 

C720 : 8D 78 04 

C723 : A9 C7 

C725 : 8D F8 07 

C728 : 08 

C729 : C5 39 

C72B : F0 E8 C715 

C72D : 28 

C72E : 4D 7F 04 

C73 1 : D0 1 A C74D 


C733 : AD FF 07 

C736 : 48 

C737 : AD 7F 07 

C73A : 48 

C73B : AD 78 04 

C73E : 60 


C73F : C73F 

C73F :8D F8 07 
C742 : C742 

C742 : 20 D3 C7 
C745 : 70 01 C748 

C747 : 60 

C748 : C748 


73 • The entry point APPLETALK must appear at 

74 • *Cn 1 2 in this and all future AppleTalk cards 

75 • for the Apple // product line. 

77 ‘AppleTalk Call 

79 • LDY # <PARAMLST 

80 * ;Y must contain hi byte of parameter list 

81 • LDX * >PARAMLST : 

82 • ;X must contain lo byte of parameter list 

83 • LDA MCn 

84 • ; A must contain the sit • of the AppleTalk card+*C0 

85 • JSR APPLETALK 

86 • ;Call the interface (in ROM in //c and in RAM 

87 • section of peripheral card in //e) 

88 • BNE ERRROUT I NE 

89 * ;<>0 then an err occurred 

91 ‘APPLETALK EQU * {FIXED entry point!!!!!!'!!!! 

92 CLC {Vector to actual routine 

93 BRA APPLETALK1 {Go to AppleTalk entry ptr 


95 • REBOOT is accessed by a JMP/JSR to *Cn15. 

96 • This causes boot code to be transferred from the 

97 • AppleTalk//c converter box ROM to the //c RAM and 

98 • causes the execution of that code. 

Jmp here to reboot AppleTalk 
{Set carry means reboot 
;No interrupts during boot 
Reset stack ptr for boot 


107 PASERR EQU • {PASCAL error entry point 

108 SEC ;Set carry for error 

109 LDX M03 {Error code for PASCAL 

110 RTS {Back to PASCAL 


100 REBOOTAPTALK EQU • 

101 SEC 

102 SEI 

103 LDX MFF 

104 TXS 

105 BRA APPLETALK2 


112 CN20F ILL EQU *C720-‘ 

113 DS CN20FILL , *00 

115 BASICENT EQU • 

116 STA SCRNTMP0 

117 LDA #*C7 

118 STA MSLOT 

119 PHP 

120 CMP KSWH 

121 BEQ REBOOTAPTALK 

122 PLP 

123 EOR SCRNHOLE0 

124 BNE APTALKOFFLN 

125 LDA SCRNH0LE2 

126 PHA 

127 LDA SCRNHOLE 1 

128 PHA 

129 LDA SCRNTMP0 

130 RTS 


132 APPLETALK 1 EQU * 

133 STA MSLOT 

134 APPLETALK2 EQU • 

135 JSR ALTROMSU 

136 BVS FOS 

137 RTS 

139 FOS EQU • 


{Fill to *Cn20 for BASICENT 

{MUST start at *Cn20 
{Save user's output byte 
;Say we're in slot 7 
{>>>>> REQUIRED <<<<< 

{Save V/C status 
;If-KSWH then IN*n was done 
{If so then must reboot 
{Restore V/C status 
{Test for driver installed 
{<>- to flag then error 
;Hl byte of prntr drv prg 
;To stack for RTS type Jump 
;Lo byte-1 of prntr drv prg 

{Restore user's output byte 
{Exit to printer driver 


; Save *Cn in case of Interrupt 

{Continue in alt ROM 
;V-1 if from boot code 
;V-0 then return to user 

{From Other Side (alt ROM) 



03 APTALK . C700 AppleTalk//c C700 Rtns 
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04 APTALK. ROMSTUFF AppleTalk//c Alt-ROM stuff 
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C748 : B0 

03 

C74D 

140 

BCS 

APTALKOFFLN 

iError so display message 









C74A :6C 

CB 

00 

141 

JMP 

(BOOTIT) 

;Start of boot code 

C580 




4 











C580 




5 

• 


• 

C74D : 


C74D 

143 

APTALKOFFLN EQU 

• 


C580 




6 

• AppleTalk //c Protocol Converter * 

C74D : AD 

81 

C0 

144 

LDA 

$C08 1 

{Switch in LC ROM 

C580 




7 

• 


• 

C750 : AD 

81 

C0 

145 

LDA 

*C081 

• 

C580 




8 

• Alternate ROM Stuff Routines • 

C753 : 20 

84 

FE 

146 

JSR 

SETNORM 

;No Inverse stuff 

C580 




9 



• 

C756 : 20 

2F 

FB 

147 

JSR 

INIT 

;Flx up some stuff 

C580 




10 


by 


C759 : 20 

58 

FC 

148 

JSR 

HOME 

;Clear screen for message 

C580 




1 1 


Fern Bachman * 

C75C : 20 

93 

FE 

149 

JSR 

SETVID 

;Screen is output device 

C580 




12 



• 

C75F : 20 

89 

FE 

150 

JSR 

SETKBD 

{Keyboard is input device 

C580 




13 

• Copyr 

lght Apple Comp 

uter, Inc. 1985 • 








C580 




14 


All Rights Reserved. * 

C762 : A0 

10 


152 

LDY 

'APOFFMSGLN- 1 

{Length of error message 

C580 




15 



• 

C764 : 


C764 

153 

APOFFLOOP EQU 

# 


CS80 




16 




C764 :B9 

6F 

C7 

154 

LDA 

APOFFMSG, Y 

{Get character to show 









C767 : 99 

DB 

07 

155 

STA 

$7DB, Y 

{Display on screen 









C76A : 88 



156 

DEY 


; 

C580 




18 

•ARAPPLETALK EQU • 

{Alternate ROM entry poin 

C76B : 10 

F7 

C764 

157 

BPL 

APOFFLOOP 

{Loop til done 

C580 

90 

59 

C5DB 

19 

BCC 

ARAPPLETALK2 

;C-0 then regular ApTalk 

C76D : 


C76D 

158 

BRAHANGLOOP EQU 

• 

{Hang til user presses reset 









C76D : 80 

FE 

C76D 

159 

BRA 

BRAHANGLOOP 

{Loop forever 
















C582 




21 

•DOBOOTCODE EQl 

• 

;Alt ROM ApTalk Reboot en 

C76F : 



161 

MSB 

ON 


C582 

A9 

C7 


22 

LDA 

MC7 

{Put $Cn at $8 for boot p 








C584 

85 

08 


23 

STA 

ZP8 


C76F : 


C76F 

163 

APOFFMSG EQU 

• 


C586 

85 

C7 


24 

STA 

TESTTMP 

{<>0 then indicates from 

C76F : C 1 

F 0 

F 0 EC 

164 

ASC 

"AppleTal k 

Offline" 

C588 

20 

06 

C6 

25 

JSR 

ARINIT1 

{Verify AppleTalk online 








C58B 

B0 

38 

C5C5 

26 

BCS 

GETC0DE4 

; C - 1 then offline 

C780 : 


0011 

166 

APOFFMSGLN EQU 

•-APOFFMSG 

{Length of error message 
















C58D 

64 

C3 


28 

STZ 

PTRBUFF ♦ 1 

{Response buffer is same 








C58F 

A9 

C2 


29 

LDA 

' >PTRBUFF 

{ as send buffer . 

C780 : 


0000 

168 

C7FILL80 EQU 

$C780 - " 

■ 

C59 1 

85 

C2 


30 

STA 

PTRBUFF 


C780 : 


0000 

169 

DS 

C7FILL80.0FF 

{Fill to version number 

C593 

A9 

09 


31 

LDA 

'CMDCREBOOT 

{Reboot command 








C595 

20 

6A 

C7 

32 

JSR 

CALLSETUP 

{Setup some stuff before 








C598 

20 

83 

C8 

33 

JSR 

ALTPRCNVENTRY 

{Call the prot conv 

0000 : 



171 

DSECT 



C59B 

00 



34 

DFB 

PCST ATUSCMD 

{Prot Conv status command 

C7FF : 


C7FF 

172 

ORG 

• C7FF 

{Version ' goes at »C7FF 

C59C 

C0 

00 


35 

DM 

ZP2CUSE 

{Parameter buffer 








C59E 

D0 

25 

C5C5 

36 

BNE 

GETC0DE4 

{<>- then errors 

C7FF : 



174 

•RELVERSION EQU 

• 

{Release version number 









C7FF : 00 



175 

DFB 

RELVERNUM 


C5A0 

A5 

C2 


38 

LDA 

PTRBUFF 

{Save start for later 








CSA2 

85 

CB 


39 

STA 

BOOTIT 









C5A4 

A5 

C3 


40 

LDA 

PTRBUFF* 1 


C780 : 



177 

DEND 



C5A6 

85 

CC 


41 

STA 

BOOT I T ♦ 1 



C580 

C580 


NEXT OBJECT FILE NAME IS APTALK. 1 


32 

33 


ORG ICS80 
INCLUDE /APPLETALK2C 


; SCS80-JC780 In aux 
.D2/APTALK. ROMSTUFF 


ROM 


CSA8 : C5A8 

C5A8 : 20 83 C8 

C5AB : 00 

C5AC : C 0 00 

C5AE : F0 25 CSD5 

C5B0 : C9 3F 

C5B2 : D0 11 C5C5 

CSB4 : 18 


43 GETC0DE2 EQU 

44 JSR 

45 DFB 

46 DM 

47 BEQ 

48 CMP 

49 BNE 

50 CLC 


ALTPRCNVENTRY ; 
PCST ATUSCMD 
ZP2CUSE 

GETC0DE5 ; 

'LASTPACKET-180 
GETC0DE4 ; 


Call the prot conv 
Prot Conv status command 
Parameter buffer 
■ then no errors 
;Last packet read yet? 

<> last pkt then error 
;C"0 If last pkt received 


C5B5 : 
C5B5 : 
C5B5: 


52 • ROM boot program received. Now enable ACIA 

53 * interrupt capability for AppleTalk boot 

54 * program. 


C5B5 : A9 C0 
C5B7 : 8D F9 05 
C5BA : A9 0F 
C5BC : 0C 9A C0 


56 

57 

58 

59 


LDA '$C0 
STA $5F9 
LDA '«F 
TSB $C09A 


Enable firmware to pass lnt 
Set up ACIA 


C5BF : C5BF 

C5BF : 2C 74 C6 
C5C2 : 4C 84 C7 


61 GETC0DE3 EQU 

62 BIT 

63 JMP 


FF 

MAINROMSU 


jV-1 to indicate from here 
*, Return to main ROM 


C5C5: C5C5 

C5C5 : 38 
C5C6 : 9C F2 03 
C5C9 : A9 E0 
C5CB : 8D F3 03 


65 GETC0DE4 EQU 

66 SEC 

67 STZ 

68 LDA 

69 STA 


SOFTEV 
'<*E000 
SOFTEV* 1 


jError exit for reboot rtne 
;C"1 on error 
; RESET vctrs to basic 
;BASIC coldstart location 
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04 APTALK . ROMSTUFF Alternate ROM entry point 
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C5DB: C5DB 

C5DB : 08 

C5DC : D8 

C5DD : 78 

C5DE : 8C 78 04 

C5E 1 : A0 0B 
C5E3: C5E3 

C5E3 : B9 BF 00 
C5E6 : 48 
C5E7 : 88 

CSE8:D0 F9 C5E3 

C5EA : 86 C9 

C5EC : AE 78 04 

C5EF : 86 CA 

C5F 1 : B 1 C9 

C5F3 : F 0 7A C6GF 

C5F5 : 30 78 C66F 

C5F7 : C9 06 

C5F9 : B0 78 C673 

C5FB : 0A 

C5FC : AA 

C5FD : C8 

C5FE : B 1 C9 

C600 : C8 

C60 1 : 7C 74 C7 


81 ARAPPLETALK2 EQU • 

82 PHP 

83 CLD 

84 SEI 

85 STY SCRNTMP0 

87 LDY # ZP2CUSELEN 

88 ARSTKSVE EQU 

89 LDA ZP2CUSE- 1 , Y 

90 PHA 

91 DEY 

92 BNE ARSTKSVE 


i Reg AppleTalk call conts here 
;Make sure no ints in here 
;MUST enter with Dec mode clear 
;Force off int ability 
;Save Y temporarily 

I g of bytes to save on stk 

;Get value to save 
;Save It 
;Test for more 
;<>“ go for more 


94 

95 

96 

97 

98 

99 
100 
101 
102 

103 

104 

105 

106 
107 


STX ADDR0 
LDX SCRNTMP0 
STX ADDR1 
LDA ( ADDR0) , Y 

BEQ ARAPTALK2 
BMI ARAPTALK2 
CMP #6 
BCS CMDEXITE 
ASL 

TAX ; 

1NY ;lnc to 2nd byte in user buff 

LDA (ADDR0),Y ;Pick up the data there 

INY ; Inc index for later 

JMP (APTALKCMDS-2 , X) ; Jump to routine 


ser aaia butter ptr 
Recall *Y' 

Hi byte of data buff ptr 
Get command * 

0 is invalid command 
- then test for DIAG call 
else test for valid * 

> “6 is ill ega 1 

Make command * into index 



04 APTALK . ROMSTUFF AppleTalk lnlt entry point 
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0604 : C604 110 ARINIT EQU • {AppleTalk init call entry 

0604:64 07 111 STZ TESTTMP ; -0 indicates from here 

0606: 0606 113 ARINIT1 EQU • ;AppleTalk init call entry 

0606:90 FE 07 114 STZ APTALKUNIT ; 

0609: 0609 115 ARINIT2 EQU * 

0609 : EE FE 07 116 INC APTALKUNIT -.Save in screen hole 

C60C : A9 0A 117 LDA 'CMDCID1 {Commands code * 

C60E : 20 6A 07 118 JSR CALLSETUP ;Set up some stuff 

061 1 : A9 07 119 LDA **C7 ;Polnt to ROM in case 

0613:85 03 120 STA PTRBUFF ♦ 1 ; some device sends us 

0615:64 02 121 STZ PTRBUFF ;Lo byte is zero 

0617:20 83 08 123 JSR ALTPRCNVENTRY ;Call the protocol converter 

C61A : 00 124 DFB PCSTATUSCMD ;Prot Conv status command 

06 IB : 00 00 125 DM ZP2CUSE {Pointer to call buffer 

C61D:C9 46 126 CMP *ID1-»80 ;ApTalk ID status code 1?? 

06 1 F : D0 0F 0630 127 BNE N0THISUNIT ;Not ID1 then maybe last uni 

0621 :E6 04 129 INC C0DECMDS {Commands code now CMDCID2 

0623:20 83 08 130 JSR ALTPRCNVENTRY {Call the protocol converter 

0626:00 131 DFB PCSTATUSCMD ;Prot Conv status command 

0627:00 00 132 DUI ZP2CUSE {Pointer to call buffer 

0629:09 42 133 CMP *ID2-»80 {ApTalk ID status code 2?? 

C62B : D0 03 0630 134 BNE N0THISUNIT {Not ID2 then maybe last uni 

C62D:18 135 CLC {If here then we've got it 

C62E : 80 04 0634 136 BRA MAYBC0NTINIT {See it we should cont INIT 


0630: 0630 138 N0THISUNIT EQU • 

0630:09 28 139 CMP *NODEVCON-»80 {Test for dev not connected 

0632 : D0 D5 0609 140 BNE ARINIT2 ; C - 1 if bad unit * tried 

0634: 0634 141 MAYBC0NTINIT EQU • ; 

0634 : A5 07 142 LDA TESTTMP ;0-lnit cal 1 -<>0-reboot call 

0636: F0 01 0639 143 BEQ ARINIT4 ;-0 then cont lnlt call 

0638:60 144 RTS ;V“1 return to reboot call 


0639: 0639 146 ARINIT4 EQU * {Continue init call here 

0639 : B0 28 0663 147 BCS D0EXIT1 -,C-1 then AppleTalk unit not 

C63B : A0 04 148 LDY 'CMDCINIT {Commands code for lnlt 

C63D : 80 02 0641 149 BRA ARINIT6 {Skip ARSTATUS entry point 


C63F : C63F 151 ARSTATUS EQU • {Alt ROM status entry point 

C63F : A0 05 152 LDY *CMDCSTATUS {Command code for status 


0641: 0641 154 ARINIT6 EQU * 

064 1 : E6 09 155 INC ADDR0 

0643 : D0 02 0647 156 BNE STUPPTRS 

0645 : E6 CA 157 INC ADDR1 

0647: 0647 158 STUPPTRS EQU 

0647 : B2 09 159 LDA (ADDR0) 

0649:85 CS 160 STA BYTEUSER 

C64B : A5 09 161 LDA ADDR0 

C64D : 85 02 162 STA PTRBUFF 

C64F : A5 CA 163 LDA ADDR1 

0651:85 03 164 STA PTRBUFF* 1 

0653:98 165 TYA 


Calculate user buffer 
C-0 then leave hi byte alon 


Get user byte 
Put in buffer 

Put in buffer 


{Move commands code to 


'A' 


0654: 0654 167 CALLBDX EQU 

0654:20 6A 07 168 JSR CALLSETUP {Setup some stuff for JSR 

0657:20 83 08 169 JSR ALTPRCNVENTRY {Go to prot conv 

C65A : 00 170 DFB PCSTATUSCMD ;Prot Conv status command 

C65B : 00 00 171 DW ZP2CUSE {Pointer to buffer 


4^ 

CTi 


04 APTALK. ROMSTUFF Exit ApTalk cmd rtnes 
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C65D : C65D 

C65D : F 0 0B C66A 

C65F : 09 30 
0661 :B0 02 0665 

0663: 0663 

0663 :A9 04 
0665: 0665 

0665:29 0F 
0667 :AA 

0668 :D0 0B 0675 

C66A : C66A 

C66A : A2 00 
0660:18 

C66D : 80 07 0676 

C66F : C66F 

C66F : 09 81 

067 1 : F0 17 C68A 

0673: 0673 

0673: 0674 

0673 : A2 FF 
0675: 0675 

0675:38 

0676: 0676 

0676 : A0 F5 
0678: 0678 

0678:68 
0679:99 CB FF 

C67C : 08 

C67D : D0 F9 0678 

C67F : B8 

0680:68 

0681:29 04 

0683 :D0 01 0686 


174 D0EX1T EQU 

175 BEQ 

176 CMP 

177 BCS 

178 D0EXIT1 EQU 

179 LDA 

180 D8EXIT2 EQU 

181 AND 

182 TAX 

183 BNE 

184 NECMDEX I T EQU 

185 LDX 

186 CLC 

187 BRA 

189 ARAPTALK2 EQU 

190 CMP 

191 BEQ 

193 CMDEXITE EQU 

194 FF EQU 

195 LDX 

196 ECMDEX IT EQU 

197 SEC 

198 CMDEXIT EQU 

199 LDY 

200 ARSTKRST EQU 


NECMDEXIT {“0 then no errors to report 

*•30 {Less than »30 then make err4 

DOE X I T2 { 

*NOUNIQUEID-$80-$30 {Make no unique id error 

**F {Lo nibble has correct error code 

{Error code must be in X 
ECMDEXIT {<>■ if errors 

• 

*0 ;0“ no error 

{C-0 - no error 
CMDEXIT {Exit now 


{Is it a D I AG ca 
{If so go do it 


*$FF {Illegal command error 

• {Error command exit 

{Set carry for error 

*• 1 00 -ZP2CUSELEN {* of bytes to restore 

{Recall value from stack 
ZP2CUSE-$1 00*ZP2CUSELEN , Y {Store value back in 
zpage 

{Next 

ARSTKRST {Loop til done 

{V-0 if from here 
{Modify entry status to reflect 
*♦04 { correct exit status 

N0TACTIVE {<>0 -ints were off at entry 


0685:58 211 CLI {If here, ints were on at entry 

0686: 0686 212 N0TACTIVE EQU * { 

C686:8A 213 TXA {Put error command in A 

0687:40 84 07 214 JMP MAINR0MSW {Exit back to main ROM 
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1 nt 


:d 


ptr 


04 APTALK . RQMSTUFF AppleTalk Rdprot/Rdrest entry 

C6BE: CGBE 2S3 ARREADPROT EQU • 

C6BE : B8 254 CLV 

CGBF :80 07 C6C8 255 BRA ARREADREST2 

C6C1: C6C 1 257 ARREADPR0T2 EQU • 

CGC 1 : A9 07 258 LDA 'CMDCREADPROT 

C6C3 : 80 8F C654 259 BRA CALLBOX 


C6C5: C6CS 261 ARREADREST EQU * 

C6C5: 2C 74 C6 262 BIT FF 

CGC8: C6C8 263 ARREADREST2 EQU * 

C6C8 : 85 C2 264 STA PTRBUFF 

C6CA : B 1 C9 26S LDA ( ADDR0) , Y 

C6CC : 85 C3 266 STA PTRBUFF* 1 

C6CE : C8 267 INY 

C6CF :B1 C9 268 LDA (ADDR0) , Y 

C6D 1 : 85 C5 269 STA BYTEUSER 

C6D3 : C8 270 INY 

CGD4 : B 1 C9 271 LDA (ADDR0) , Y 

C6D6 : 85 C6 272 STA BYTEHINUM 

C6D8 : 50 E7 C6C 1 273 BVC ARREADPR0T2 

C6DA : A9 06 274 LDA 'CMDCREADREST 

C6DC : 20 6A C7 275 JSR CALLSETUP 

C6DF : 20 83 C8 276 JSR ALTPRCNVENTRY 

C6E2 : 0 0 277 DFB PCSTATUSCMD 

C6E3 : C0 00 278 DW ZP2CUSE 

C6E5 : 48 279 PHA 

C6E6 : 5A 280 PHY 

C6E7 : A0 04 281 LDY #4 

C6E9 : 8A 282 TXA 

C6EA : 9 1 C9 283 STA (ADDR0) , Y 

C6EC.-68 284 PLA 

C6ED : C8 285 INY 

C6EE :91 C9 286 STA (ADDR0) , Y 

C6F 0 : 68 287 PLA 

C6F1: C6F 1 289 ARREXIT EQU • 

C6F 1 : 4C 5D C6 290 JMP DOEXIT 


;Read protocol entry point 
{Clear V if from here 
{Start Into readrest routine 


{Readprot command code 
{Call box for execution 


{AppleTalk readrest call entry 
{Sets V flag 

{AppleTalk readrest call entry 
{'A' has lo byte of RAM ptr 
{'A' has hi byte of RAM ptr 

{Get/move 2 more bytes 


{V»0 then exit here 
{Readrest command code 
{Set up some stuff for JSR 
{Call the prot conv 
{Prot Conv status command 
{Buffer pointer 
{Save for awhile 
{Save for awhile 

{Put * of bytes read in user buff 
{Move to A to save 

{Move hi byte too 
{Next loc in user buff 

{Restore error byte 
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C740 : B1 C9 364 LDA 

C742 : 85 C2 365 STA 

C744 : C8 366 INY 

C745 : B 1 C9 367 LDA 

C747 : 85 C3 368 STA 

C749 : C8 369 INY 

C74A : D0 02 C74E 370 BNE 

C74C : E6 CA 371 INC 

C74E : C74E 372 ARWRITE4 EQU 

C74E : 84 C7 373 STY 

C750 : 20 83 C8 374 JSR 

C753 : 09 375 DFB 

C754 : C0 00 376 DUI 

C756 : D0 99 C6F1 377 BNE 

C758 : A4 C7 378 LDY 

C75A : 80 D6 C732 379 BRA 

C75C : C75C 381 SAYSENDIT EQU 

C75C : 64 C4 382 STZ 

C75E : 64 C5 383 STZ 

C760 :85 C6 384 STA 

C762 : 20 83 C8 385 JSR 

C765 : 09 386 DFB 

C766 : C0 00 387 DU 

C768 : 80 87 C6F1 388 BRA 


(ADDR0) , Y ; 

PTRBUFF ; 

(ADDR0) , Y 
PTRBUFF ♦ 1 ; 

'.Ready for next loop 

ARURITE4 ; Sk ip inc 

ADDR1 ;For page cross 

TESTTMP ; MUST preserve ' Y ' 

ALTPRCNVENTRY ;Call prot conv 
PCURITECMD ;Prot Conv write command 

ZP2CUSE ; Buffer 

ARREXIT iError then exit 

TESTTMP ; Restore Y 

ARURITE2 ; Loop til done 


NUMLOUR ITE 

NUMHIURITE 

TYPEWRITE 

ALTPRCNVENTRY 

PCURITECMD 

ZP2CUSE 

ARREXIT 


If here last packet was sent 
0 out * of bytes this packet 

<>0 means send Aptalk pkt 
Call prot conv 
Prot Conv write command 
Buffer 

Return to user 



4 ^ 

-<J 

O 


04 APTALK . ROMSTUFF AppleTalk ROMSTUFF subr tns/ tables 


29- JUL-85 18:33 PAGE 17 


C76A: C76A 392 CALLSETUP EQU • 

C76A : 85 C4 393 STA CODECMDS 

C76C : A9 06 394 LDA 'PC0UNTS4.B 


Setup some stuff for Prot Conv 
Save cmd code for Prot Conv 
* of parameters for call 


C76E : C76E 396 CALLSETUP2 EQU 

C76E : 85 C0 397 STA 

C770.-AD FE 07 398 LDA 

C773 : 85 Cl 399 STA 

C775 : 60 400 RTS 


PARAMNUM 

APTALKUNIT 

NUMUNIT 


Alternate entry point 

Move unit number to buff 
Put In buffer 
;Back to caller 


C776: C776 402 APTALKCMDS EQU 


C776 : 04 C6 403 DW 
C778 : C5 C6 404 DM 
C77A : F4 C6 405 DM 
C77C : 3F C6 406 DM 
C77E : BE C6 407 DM 


ARINIT ;AppleTalk lnlt call 

ARREADREST ;AppleTalk readrest call 

ARMRITE ;AppleTalk write call 

ARSTATUS ; App 1 eTa 1 k status call 

ARREADPROT ;AppleTalk readprot call 


C780: 0000 409 ROMSTUFFF ILL EQU $C780-» 

C78B: 0000 410 DS ROMSTUFFF I LL , IFF ; Fl 1 1 character 


C780: 34 ELSE 

35 LST ASYM.VSYM ;List by symbol and address 

S 36 SKP 2 


04 SYMBOL TABLE 
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C9 ADDR0 CA ADDR1 

C764 APOFFLOOP 0011 APOFFMSGLN 

C742 APPLETALK2 C776 APTALKCMDS 

C5DB ARAPPLETALK2 C66F ARAPTALK2 

C68A ARDIAG C6B1 ARDIAG4 

C606 ARINIT1 C609 ARINIT2 

C6C 1 ARREADPR0T2 C6C8 ARREADREST2 

C63F ARSTATUS C678 ARSTKRST 

C6F4 ARMRITE C732 ARMRITE2 

C720 BASICENT CB BOOTIT 

BS BYTEGTR603 C6 BYTEHINUM 

CS BYTEUSER 00 C7FILL80 

C76A CALLSETUP 08 CMDCDIAG 

07 CMDCREADPROT 06 CMDCREADREST 

? 81 CMDERROR C676 CMDEXIT 

C4 CODECMDS ? A1 CODERROR 

C665 D0EXIT2 C6SD DOEXIT 

C674 FF C748 FOS 

C5A8 GETC0DE2 CSBF GETC0DE3 

FC58 HOME C6 ID1 

FB2F INIT C729 I TSHORTENUF 

? Cl LSTNONBT C784 MAINROMSM 

C66A NECMDEX I T A8 NODEVCON 

C630 NOTH I SUN I T ? BA NOTMYINTER 
C4 NUMLOMRITE Cl NUMUNIT 

? 03 PCOUNTC ? 02 PCOUNTI 

04 PCOUNTM 00 PCSTATUSCMD 

? B3 READPSTEND C715 REBOOTAPTALK 

C75C SAYSENDIT 047F SCRNHOLE0 

0478 SCRNTMP0 C702 SEND2MANYLP 

FE93 SETVID 03F2 SOFTEV 

? B8 TOOMANYCOL C703 TOSETV 

C0 ZP2CUSE 0B ZP2CUSELEN 

•* SUCCESSFUL ASSEMBLY :- NO ERRORS 
•* ASSEMBLER CREATED ON 1S-JAN-84 21:28 
** TOTAL LINES ASSEMBLED 963 

*• FREE SPACE PAGE COUNT 78 


C883 ALTPRCNVENTRY C7D3 ALTROMSM 

C76F APOFFMSG C73F APPLETALK 1 

C74D APTALKOFFLN 07FE APTALKUNIT 

C694 ARDIAG1 C6A3 ARDIAG2 

C641 ARINIT6 C604 ARINIT 

C639 ARINIT4 C6BE ARREADPROT 

C6C5 ARREADREST C6F 1 ARREXIT 

C5E3 ARSTKSVE C74E ARMRITE4 

? A2 BADPCNT ? 91 BADUNIT 

C76D BRAHANGLOOP ? B2 BUFFEROVER 

? B6 BYTELES003 CS BYTELONUM 

C654 CALLBOX C76E CALLSETUP2 

0 A CMDCID1 04 CMDCINIT 

09 CMDCREBOOT 05 CMDCSTATUS 

C673 CMDEXITE 00 CN20FILL 

81 DIAGCMD C663 DOEXIT1 

C67S ECMDEXIT ? B7 EXCESSDEFS 

C71C FOUNDEND 01 GENERAL 

C5CS GETC0DE4 CSD5 GETC0DE5 

C2 ID2 ? B9 ILLLAPTYPE 

39 KSMH BF LASTPACKET 

C634 MA YBCONT INIT 07F8 MSLOT 

? B 1 NOPKTINBUF C686 NOTACTIVE 

B4 NOUN I QUE I D CS NUMHIMRITE 

C0 PARAMNUM C71C PASERR 

? 03 PCOUNTS0 . 3 06 PC0UNTS4 . B 

09 PCMRITECMD C2 PTRBUFF 

00 RELVERNUM 00 ROMSTUFFF I LL 

077F SCRNHOLE 1 07FF SCRNH0LE2 

FE89 SETKBD FE84 SETNORM 

C647 STUPPTRS C7 TESTTMP 

00 TMOCBOX C6 TYPEMRITE 

08 ZP8 



Glossary 


65C02: The microprocessor used in 
the Apple lie computer. 

ACIA: Asynchronous 
communications interface adapter. 

A single chip that converts data 
from parallel to serial form, and vice 
versa, and handles serial 
transmission and reception and 
RS-232-C signals, under the control 
of its internal registers set and 
changed by firmware or software. 

accumulator: The register in the 
6502 and 65C02 microprocessors 
where most computations are 
performed. 

acronym: A word formed from the 
initial letters of a name or phrase, 
such as ROM, from read-only 
memory. 

ADC: See analog-to-digital 
converter. 

address: A number used to identify 
something, such as a location in the 
computer’s memory. 

analog: Represented in terms of a 
physical quantity that can vary 
smoothly and continuously over a 
range of values. For example, a 
conventional 12-hour clock face is 
an analog device that represents the 
time of day in terms of the angles of 
the clock’s hands. Compare digital. 


analog-to-digital converter: A 

device that converts quantities from 
analog to digital form. For example, 
the Apple lie’s hand controller 
converts the position of the 
controller dial (an analog quantity) 
into a discrete number (a digital 
quantity) that changes in steps even 
when the dial is turned smoothly. 

AND: A logical operator that 
produces a true result if both of its 
operands are true, a false result if 
either or both of its operands are 
false; compare OR, exclusive OR, 
NOT. 

Applesoft: An extended version of 
the BASIC programming language 
used with the Apple lie computer. 
The firmware for interpreting and 
executing programs in Applesoft is 
included in the Apple lie ROM. 

ASCII: American Standard Code 
for Information Interchange; a code 
in which the numbers from 0 to 127 
stand for text characters, used for 
representing text inside a computer 
and for transmitting text between 
computers or between a computer 
and a peripheral device. 


assembler: A language translator 
that converts a program written in 
assembly language into an 
equivalent program in machine 
language. 

assembly language: A low-level 
programming language in which 
individual machine-language 
instructions are written in a 
symbolic form more easily 
understood by a human programmer 
than machine language itself. 

asserted: Made true (positive in 
positive-true logic; negative in 
negative-true logic). 

asynchronous: Having a variable 
time interval between characters. 

back panel: The rear face of the 
Apple lie computer, which includes 
the power switch, the power 
connector, and connectors for two 
serial devices, a video display 
device, an external disk drive, and a 
mouse or hand control. 

bandwidth: A measure of the 
range of frequencies a device can 
handle. In the case of a video 
monitor, greater bandwidth enables 
it to display more information; to 
display 80 columns of text, a 
monitor should have a bandwidth of 
at least 12 MHz. 
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base address: In indexed 
addressing, the fixed component of 
an address. 

baud: A unit of signaling speed 
equal to the number of discrete 
conditions or signal events per 
second. Often equated (though not 
precisely) with bits per second. 

binary: The representation of 
numbers in terms of powers of 2, 
using the two digits 0 and 1. 
Commonly used in computers, since 
the values 0 and 1 can easily be 
represented in physical form in a 
variety of ways, such as the 
presence or absence of current, 
positive or negative voltage, or a 
white or black dot on the display 
screen. 

bit: A binary digit (0 or 1); the 
smallest possible unit of 
information, consisting of a simple 
two-way choice, such as yes or no, 
on or off, positive or negative, 
something or nothing. 

board: See printed-circuit board. 

boot: To start up a computer by 
loading a program into memory 
from an external storage medium 
such as a disk. Often accomplished 
by first loading a small program 
whose purpose is to read the larger 
program into memory. The program 
is said to pull itself in by its own 
bootstraps. 


bootstrap: See boot. 

BREAK: A SPACE (0) signal sent 
over a communication line, of long 
enough duration to interrupt the 
sender. This signal is often used to 
end a session with a timesharing 
service. 

BRK: A 65C02 instruction that 
causes the microprocessor to halt. 

buffer: An area of the computer’s 
memory used as a holding area 
where information can be stored by 
one program or device and then 
read out by another at a different 
speed. 

bus: A group of wires that transmit 
related information from one part of 
a computer system to another. In 
the Apple lie, the address bus has 
16 wires, and the data bus has 8. 

byte: A unit of information 
consisting of a fixed number of bits; 
on the Apple lie, one byte consists 
of eight bits and can represent any 
value between 0 and 255. 


carriage return: An ASCII 
character (decimal 13; Appendix H) 
that ordinarily causes a printer or 
display device to place the 
subsequent character on the left 
margin. On a manual typewriter, 
this movement is combined with 
line feed (the advancement of the 
paper to the next line). With 
computers, carriage return and line 
feed are separate, causing 
hair-raising problems for the user. 

carrier: The background signal on 
a communication channel that is 
modified to carry the information. 
Under RS-232-C rules, the carrier 
signal is equivalent to a continuous 
MARK (1) signal; a transition to 0 
then represents a start bit. 

carry flag: The C bit in the 65C02 
processor status register, used to 
hold the carry bit in addition and 
subtraction. 

cathode-ray tube: An electronic 
device, such as a television picture 
tube, that produces images on a 
screen coated with phosphors that 
emit light when struck by a focused 
beam of electrons. 

central processing unit: See 
processor. 

character: A letter, digit, 
punctuation mark, or other symbol 
used in printing, displaying or 
transferring information. 
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character code: A number used to 
represent a text character for 
processing by a computer system. 

chip: The small piece of 
semiconducting material (usually 
silicon) on which an integrated 
circuit is fabricated. 

Clear To Send: An RS-232-C signal 
from a DCE to a DTE that is 
normally kept false until the DCE 
makes it true, indicating that all 
circuits are ready to transfer data 
out. 

code: (1) A number or symbol used 
to represent some piece of 
information in a compact or easily 
processed form. (2) The statements 
or instructions making up a 
program. 

cold start: The process of starting 
up the Apple lie when the power is 
first turned on (or as if the power 
had just been turned on) by loading 
the operating system into main 
memory, then loading and running a 
program. Compare warm start. 

command: A communication from 
the user to a computer system 
(usually typed from the keyboard) 
directing it to perform some action. 


command character: An ASCII 
character, usually CONTROL-A or 
CONTROL-I, that causes the serial 
port firmware to interpret 
subsequent characters as a 
command. 

command register: An ACIA 
location (at address $C09A for port 1 
and $C0AA for port 2) that stores 
parity type and RS-232-C signal 
characteristics. 

communication mode: An 

operating state in which serial 
port 2 (or 1, if so set) is prepared to 
exchange data and signals with a 
DCE (such as a modem). 

compiler: A language translator 
that converts a program written in a 
high-level programming language 
into an equivalent program in some 
lower-level language (such as 
machine language) for later 
execution. Compare interpreter. 

composite video: A video signal 
that includes both display 
information and the synchronization 
(and other) signals needed to 
display it. 

computer: An electronic device for 
performing predefined 
(programmed) computations at high 
speed and with great accuracy. 


computer system: A computer 
and its associated hardware, 
firmware, and software. 

connector: A physical device such 
as a plug, socket, or jack, used to 
connect two devices to one another. 

control character: A character 
that controls or modifies the way 
information is printed or displayed. 
Control characters have ASCII 
codes between $00 and $1F (or 
between $80 and $9F if the 
high-order bit is set)). You can 
generate them at the Apple lie 
keyboard by holding down the 
I control | key while typing one of 
the letter keys or [ \ ] or 

control register: An ACIA 
location (at address $C09B for 
port 1, or $C0AB for port 2) that 
stores data format and baud rate 
selections. 

CPU: Central processing unit; see 

processor. 

CRT: See cathode-ray tube. 

CTS: See Clear To Send. 

cursor: A symbol displayed on the 
screen that marks where the user’s 
next action will take effect or where 
the next character typed from the 
keyboard will appear. 
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DAC: See digital-to-analog 
converter. 

data: Information; especially 
information used or operated on by 
a program. 

data bit: One of five to eight bits 
representing a character. 

Data Carrier Detect: An 

RS-232-C signal from a DCE (such 
as a modem) to a DTE (such as an 
Apple lie) indicating that a 
communication connection has 
been established. 

Data Communication 
Equipment: As defined by the 
RS-232-C standard, any device that 
transmits or receives information. 
Usually this is a modem. However, 
when a Modem Eliminator is used, 
the Apple lie itself looks like a DCE 
to the other device, and the other 
device looks like a DCE to the 
Apple lie. 

data format: The form in which 
data are stored, manipulated, or 
transferred. Serial data transmitted 
and received by port 1 or 2 have a 
data format of: one start bit, five to 
eight data bits, an optional parity 
bit, and one, one and a half, or two 
stop bits. 


Data Set Ready: An RS-232-C 
signal from a DCE to a DTE 
indicating that the DCE has 
established a connection. 

Data Terminal Equipment: As 

defined by the RS-232-C standard, 
any device that generates or absorbs 
information, thus acting as a 
terminus of a communication 
connection. 

Data Terminal Ready: An 

RS-232-C signal from a DTE to a 
DCE indicating a readiness to 
transmit or receive data. 

DCD: See Data Carrier Detect. 

DCE: See Data Communication 
Equipment. 

debug: To locate and correct an 
error or the cause of a problem or 
malfunction in a computer system. 
Typically used to refer to 
software-related problems. 

decimal: The common form of 
number representation in everyday 
usage, in which numbers are 
expressed in terms of powers of 10, 
using the ten digits 0 to 9. 

default: A value, action, or setting 
that is assumed or set in the 
absence of explicit instructions 
otherwise. 


demodulate: To recover the 
information being transmitted by a 
modulated signal; for example, a 
conventional radio receiver 
demodulates an incoming broadcast 
signal to convert it into sound 
emitted by a speaker. 

device: (1) A physical apparatus for 
performing a particular task or 
achieving a particular purpose. 

(2) In particular, a hardware 
component of a computer system. 

digit: (1) One of the characters 0 
to 9, used to express numbers in 
decimal form. (2) One of the 
characters used to express numbers 
in some other form, such as 0 and 1 
in binary or 0 to 9 and A to F in 
hexadecimal. 

digital: Represented in a discrete 
(noncontinuous) form, such as 
numerical digits. For example, 
contemporary digital clocks display 
the time in numerical form (such 
as 2:57) instead of using the 
positions of a pair of hands on a 
clock face. Compare analog. 

digital-to-analog converter: A 

device that converts quantities from 
digital to analog form. 

DIP: See dual in-line package. 
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disassembler: A language 
translator that converts a 
machine-language program into an 
equivalent program in assembly 
language, more easily understood by 
a human programmer. The opposite 
of an assembler. 

disk: An information storage 
medium consisting of a flat, circular 
magnetic surface on which 
information can be recorded in the 
form of small magnetized spots, 
similarly to the way sounds are 
recorded on tape. 

disk drive: A device that writes 
and reads information on the 
surface of a magnetic disk. 

diskette: A term sometimes used 
for the small (514-inch) flexible 
disks used with the Apple Disk II 
drive. 

Disk lie drive: A model of disk 
drive made and sold by Apple 
Computer for use with the Apple lie 
computer; uses 514-inch flexible 
(floppy) disks. 

Disk Operating System: An 

optional software system for the 
Apple He that enables the computer 
to control and communicate with 
one or more Disk II drives. 


display: (1) Information exhibited 
visually, especially on the screen of 
a display device. (2) To exhibit 
information visually. (3) A display 
device. 

display device: A device that 
exhibits information visually, such 
as a television receiver or video 
monitor. 

display screen: The glass or 
plastic panel on the front of a 
display device, on which images are 
displayed. 

DOS: See Disk Operating 
System. 

DSR: See Data Set Ready. 

DTE: See Data Terminal 
Equipment. 

DTR: See Data Terminal Ready. 

dual in-line package: An 

integrated circuit packaged in a 
narrow rectangular box with a row 
of metal pins along each side; 
similar in appearance to an armored 
centipede. 

echo: To send an input character to 
a video display, printer, or other 
output device. 

edit: To change or modify; for 
example, to insert, remove, replace, 
or move text in a document. 


editor: A program that enables the 
user to create and edit information 
of a particular form; for example, a 
text editor or a graphics editor. 

effective address: In 

machine-language programming, 
the address of the memory location 
on which a particular instruction 
actually operates, which may be 
arrived at by indexed addressing or 
some other addressing method. 

emulation mode: A manner of 
operating in which one computer or 
interface imitates another. 

even parity: Use of an extra bit set 
to 0 or 1 as necessary to make the 
total number of 1 bits (among the 
data bits plus the parity bit) an even 
number. 

error message: A message 
displayed or printed to notify the 
user of an error or problem in the 
execution of a program. 

escape mode: A state of the 
Apple lie computer, entered by 
pressing the fiscl key, in which 
certain keys on the keyboard take 
on special meanings for positioning 
the cursor and controlling the 
display of text on the screen. 
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escape sequence: A sequence of 
keystrokes, beginning with [esc], 
used for positioning the cursor and 
controlling the display of text on the 
screen. 

exclusive OR: A logical operator 
that produces a true result if one of 
its operands is true and the other 
false, a false result if its operands 
are both true or both false; compare 
OR, AND, NOT. 

execute: To perform or carry out a 
specified action or sequence of 
actions, such as those described by 
a program. 

firmware: Software stored 
permanently in hardware: programs 
in read-only memory (ROM). Such 
programs (for example, the 
Applesoft interpreter and the 
Apple lie Monitor program) are built 
into the computer at the factory; 
they can be executed at any time 
but cannot be modified or erased 
from main memory. Compare 
hardware, software. 

fixed-point: A method of 
representing numbers inside the 
computer in which the decimal 
point (more correctly, the binary 
point) is considered to occur at a 
fixed position within the number. 
Typically, the point is considered to 
lie at the right end of the number, so 
that the number is interpreted as an 
integer. Compare floating-point. 


flexible disk: A disk made of 
flexible plastic; often called a 
floppy disk. Compare rigid disk. 

floating-point: A method of 
representing numbers inside the 
computer in which the decimal 
point (more correctly, the binary 
point) is permitted to float to 
different positions within the 
number. Some of the bits within the 
number itself are used to keep track 
of the point’s position. Compare 
fixed-point. 

form feed: An ASCII character 
(decimal 12; Appendix H) that 
causes a printer or other 
paper-handling device to advance to 
the top of the next page. 

framing error: In serial data 
transfer, absence of the expected 
stop bit(s) at the end of a received 
character. The serial port 1 and 2 
ACIAs record this error by setting 
bit 1 (FRM) of its status register to 1. 
The ACIA checks and records each 
framing error separately: if the next 
character is OK, the FRM bit is 
cleared. 

full duplex: Capable of 
simultaneous two-way 
communication. 


graphics: (1) Information 
presented in the form of pictures or 
images. (2) The display of pictures 
or images on a computer’s display 
screen. Compare text. 

half duplex: Capable of 
communication in one direction at a 
time. 

hand controller: An optional 
peripheral device that can be 
connected to the Apple He’s hand 
controller connector and has a 
rotating dial and a pushbutton; 
typically used to control 
game-playing programs, but can be 
used in more serious applications as 
well. 

hand controller connector: A 

9-pin connector on the Apple He’s 
back panel, used for connecting 
hand controllers to the computer. 

hardware: Those components of a 
computer system consisting of 
physical (electronic or mechanical) 
devices. Compare software, 
firmware. 

hertz: The unit of frequency of 
vibration or oscillation, also called 
cycles per second; named for the 
physicist Heinrich Hertz and 
abbreviated Hz. The Apple He’s 
65C02 microprocessor operates at a 
clock frequency of 1 million hertz, 
or 1 megahertz (MHz). 
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hexadecimal: The representation 
of numbers in terms of powers of 
sixteen, using the sixteen digits 0 
to 9 and A to F. Hexadecimal 
numbers are easier for humans to 
read and understand than binary 
numbers, but can be converted 
easily and directly to binary form: 
each hexadecimal digit corresponds 
to a sequence of four binary digits, 
or bits. 

high-level language: A 

programming language that is 
relatively easy for humans to 
understand. A single statement in a 
high-level language typically 
corresponds to several instructions 
of machine language. 

high-order byte: The more 
significant half of a memory address 
or other two-byte quantity. In the 
Apple He’s 65C02 microprocessor, 
the low-order byte of an address is 
usually stored first and the 
high-order byte second. 

high-resolution graphics: The 

display of graphics on the 
Apple He’s display screen as a 
six-color array of points, 

280 columns wide and 192 rows 
high. 


hold time: In computer circuits, 
the amount of time a signal must 
remain valid after some related 
signal has been turned off; compare 

setup time. 

Hz: See hertz. 

IC: See integrated circuit. 

index: (1) A number used to 
identify a member of a list or table 
by its sequential position. (2) A list 
or table whose entries are identified 
by sequential position. (3) In 
machine-language programming, 
the variable component of an 
indexed address, contained in an 
index register and added to the base 
address to form the effective 
address. 

indexed addressing: A method of 
specifying memory addresses used 
in machine-language programming. 

index register: A register in a 
computer processor that holds an 
index for use in indexed addressing. 
The Apple He’s 65C02 
microprocessor has two index 
registers, called the X register and 
the Y register. 


input: (1) Information transferred 
into a computer from some external 
source, such as the keyboard, a disk 
drive, or a modem. (2) The act or 
process of transferring such 
information. 

instruction: A unit of a 
machine-language or 
assembly-language program 
corresponding to a single action for 
the computer’s processor to 
perform. 

integer: A whole number, with no 
fractional part; represented inside 
the computer in fixed-point form. 
Compare real number. 

integrated circuit: An electronic 
component consisting of many 
circuit elements fabricated on a 
single piece of semiconducting 
material, such as silicon; see chip. 

interface: The devices, rules, or 
conventions by which one 
component of a system 
communicates with another. 

interpreter: A language translator 
that reads a program written in a 
particular programming language 
and immediately carries out the 
actions that the program describes. 
Compare compiler. 
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interrupt: A temporary suspension 
in the execution of a program by a 
computer in order to perform some 
other task, typically in response to a 
signal from a peripheral device or 
other source external to the 
computer. 

inverse video: The display of text 
on the computer’s display screen in 
the form of black dots on a white (or 
other single phosphor color) 
background, instead of the usual 
white dots on a black background. 

I/O: Input/output; the transfer of 
information into and out of a 
computer. See input, output. 

I/O device: Input/output device; a 
device that transfers information 
into or out of a computer. See 

input, output, peripheral 
device. 

I/O link: A fixed location that 
contains the address of an 
input/output subroutine in the 
Apple lie Monitor program. 

K: Two to the tenth power, or 1024 
(from the Greek root kilo, meaning 
one thousand); for example, 64K 
equals 64 times 1024, or 65,536. 

keyboard: The set of keys built 
into the Apple lie computer, similar 
to a typewriter keyboard, for typing 
information to the computer. 


keystroke: The act of pressing a 
single key or a combination of keys 
(such as I control H~c1) on the 
Apple lie keyboard. 

kilobyte: A unit of information 
consisting of IK (1024) bytes, or 
8K (8192) bits; see K. 

KSW: The symbolic name of the 
location in the Apple He’s memory 
where the standard input link is 
stored; stands for keyboard switch. 

See I/O link. 

language: See programming 
language. 

language translator: A system 
program that reads a program 
written in a particular programming 
language and either executes it 
directly or converts it into some 
other language (such as machine 
language) for later execution. See 
interpreter, compiler, 
assembler. 

least significant bit: The 

right-hand bit of a binary number as 
written down; its positional value 
isOorl. 

line feed: An ASCII character 
(decimal 10; Appendix H) that 
ordinarily causes a printer or video 
display to advance to the next line. 


load: To transfer information from 
a peripheral storage medium (such 
as a disk) into main memory for use; 
for example, to transfer a program 
into memory for execution. 

local: Nearby; capable of direct 
connection using wires only. 

location: See memory location. 

logical operator: An operator, 
such as AND, that combines logical 
values to produce a logical result. 

low-level language: A 

programming language that is 
relatively close to the form that the 
computer’s processor can execute 
directly. Low-level languages 
available for the Apple lie include 
65C02 machine language and 65C02 
assembly language. 

low-order byte: The less 
significant half of a memory address 
or other two-byte quantity. In the 
Apple He’s 65C02 microprocessor, 
the low-order byte of an address is 
usually stored first and the 
high-order byte second. 

low-power Schottky: A type of 
TTL integrated circuit having lower 
power and higher speed than a 
conventional TTL integrated circuit. 
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low-resolution graphics: The 

display of graphics on the 
Apple He’s display screen as a 
16-color array of blocks, 40 columns 
wide and 48 rows high. 

machine language: The form in 
which instructions to a computer 
are stored in memory for direct 
execution by the computer’s 
processor. Each model of computer 
processor (such as the 65C02 
microprocessor used in the 
Apple lie) has its own form of 
machine language. 

main memory: The memory 
component of a computer system 
that is built into the computer itself 
and whose contents are directly 
accessible to the processor. 

MARK parity: A bit of value 1 
appended to a binary number for 
transmission. The receiving device 
can then check for errors by looking 
for this value on each character. 

memory: A hardware component 
of a computer system that can store 
information for later retrieval; see 

main memory, random-access 
memory, read-only memory, 
read-write memory. 


memory location: A unit of main 
memory that is identified by an 
address and can hold a single item 
of information of a fixed size; in the 
Apple lie, a memory location holds 
one byte, or eight bits, of 
information. 

MHz: Megahertz; one million hertz. 

See hertz. 

microcomputer: A computer, such 
as the Apple lie, whose processor is 
a microprocessor. 

microprocessor: A computer 
processor contained in a single 
integrated circuit, such as the 65C02 
microprocessor used in the 
Apple lie. 

microsecond: One millionth of a 
second; abbreviated ns. 

millisecond: One thousandth of a 
second; abbreviated ms. 

mode: A state of a computer or 
system that determines its behavior. 

modem: Modulator/demodulator; a 
peripheral device that enables the 
computer to transmit and receive 
information over a telephone line; a 
DCE that connects a DTE to 
communication lines. 

modem eliminator: The physical 
crossing of wires that replaces a pair 
of modems for direct connection of 
two DTEs. 


modulate: To modify or alter a 
signal so as to transmit information; 
for example, conventional broadcast 
radio transmits sound by 
modulating the amplitude 
(amplitude modulation, or AM) or 
the frequency (frequency 
modulation, or FM) of a carrier 
signal. 

monitor: See video monitor. 

Monitor program: A system 
program built into the Apple lie in 
firmware, used for directly 
inspecting or changing the contents 
of main memory and for operating 
the computer at the 
machine-language level. 

most significant bit: The leftmost 
bit of a binary number as written 
down. This bit represents 0 or 
1 times 2 to the power one less than 
the total number of bits in the 
binary number. For example, in the 
binary number 10000, which 
contains five digits, the 1 represents 
1 times 2 to the 4th power — or 16. 

nanosecond: One billionth (in 
British usage, one 
thousand-millionth) of a second; 
abbreviated ns. 
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network: A collection of 
interconnected, individually 
controlled computers, together with 
the hardware and software used to 
connect them. 

nibble: A unit of information equal 
to half a byte, or four bits; can hold 
any value from 0 to 15. Sometimes 
spelled nybble. 

NOT: A unary logical operator that 
produces a true result if its operand 
is false, a false result if its operand 
is true; compare AND, OR, 
exclusive OR. 

NTSC: (1) National Television 
Standards Committee; the 
committee that defined the 
standard format used for 
transmitting broadcast video signals 
in the United States. (2) The 
standard video format defined by 
the NTSC. 

object code: See object 
program. 

object program: The translated 
form of a program produced by a 
language translator such as a 
compiler or assembler; also called 
object code. Compare source 
program. 

odd parity: Use of an extra bit set 
to 0 or 1 as necessary to make the 
total number of 1-bits an odd 
number. 


opcode: See operation code. 

operand: A value to which an 
operator is applied; the value on 
which an opcode operates. 

operating system: A software 
system that organizes the 
computer’s resources and 
capabilities and makes them 
available to the user or to 
application programs running on the 
computer. 

operation code: The part of a 
machine-language instruction that 
specifies the operation to be 
performed; often called opcode. 

operator: A symbol or sequence of 
characters, such as + or AND, 
specifying an operation to be 
performed on one or more values 
(the operands) to produce a result. 

OR: A logical operator that 
produces a true result if either or 
both of its operands are true, a false 
result if both of its operands are 
false; compare exclusive OR, 

AND, NOT 

output: Information transferred 
from a computer to some external 
destination, such as the display 
screen, a disk drive, a printer, or a 
modem. 


overrun: A condition that occurs 
when the Apple lie processor does 
not retrieve a received character 
from the ACIA’s receive data 
register before the subsequent 
character arrives. The ACIA 
automatically sets bit 2 (OVR) of its 
status register; subsequent 
characters are lost. The receive data 
register contains the last valid data 
word received. 

page: (1) A screenful of information 
on a video display, consisting on the 
Apple lie of 24 lines of 40 or 
80 characters each. (2) An area of 
main memory containing text or 
graphical information being 
displayed on the screen. (3) A 
segment of main memory 256 bytes 
long and beginning at an address 
that is an even multiple of 
256 bytes. 

page zero: See zero page. 

parallel interface: An interface in 
which many bits of information 
(typically eight bits, or one byte) are 
transmitted simultaneously over 
different wires or channels. 

Compare serial interface. 

parity: Maintenance of a sameness 
of level or count, usually the count 
of 1-bits in each character, for error 
checking. 
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parity error: Absence of the 
correct parity bit value in a received 
character. The serial port ACIAs 
record this error by setting bit 0 
(PAR) of their status registers to 1. 

PC board: See printed-circuit 
board. 

phase: (1) A stage in a periodic 
process; a point in a cycle; for 
example, the 65C02 microprocessor 
uses a clock cycle consisting of two 
phases called </>0 and </>l. (2) The 
relationship between two periodic 
signals or processes; for example, in 
NTSC color video, the color of a 
point on the screen is expressed by 
the instantaneous phase of the 
video signal relative to the color 
reference signal. 

pointer: An item of information 
consisting of the memory address of 
some other item. 

pop: To remove the top entry from 
a stack. 

port: The point of connection, 
usually a physical connector, 
between a computer and a 
peripheral device, another 
computer, or a network. 

power supply: The hardware 
component of a computer that 
draws electrical power from a 
power outlet and converts it to the 
forms needed by some other 
hardware component. 


printed-circuit board: A 

hardware component of a computer 
or other electronic device, 
consisting of a flat, rectangular 
piece of rigid material, commonly 
fiberglass, from which all 
conducting material except the 
desired circuits is etched, and to 
which integrated circuits and other 
electronic components are 
connected. 

processor: The hardware 
component of a computer that 
performs the actual computation by 
directly executing instructions 
represented in machine language 
and stored in main memory. 

program: (1) A set of instructions 
describing actions for a computer to 
perform in order to accomplish some 
task, conforming to the rules and 
conventions of a particular 
programming language. (2) To write 
a program. 

programming language: A set of 

rules or conventions for writing 
programs. 

prompt: To remind or signal the 
user that some action is expected, 
typically by displaying a distinctive 
symbol, a reminder message, or a 
menu of choices on the display 
screen. 


prompt character: A text 
character displayed on the screen to 
prompt the user for some action. 
Often also identifies the program or 
component of the system that is 
doing the prompting; for example, 
the prompt character ] is used by 
the Applesoft BASIC interpreter, > 
by Integer BASIC, and * by the 
System Monitor program. 

prompt message: A message 
displayed on the screen to prompt 
the user for some action. 

protocol: A predefined exchange of 
control signals between devices 
enabling them to prepare for and 
carry out coordinated data transfers. 

push: To add an entry to the top of 
a stack. 

radio-frequency modulator: A 

device for converting the video 
signals produced by a computer to a 
form that can be accepted by a 
television receiver. 

RAM: See random-access 
memory. 


Glossary 


481 


random-access memory: Memory 
in which the contents of individual 
locations can be referred to in an 
arbitrary or random order. 

raster: The pattern of parallel lines 
making up the image on a video 
display screen. The image is 
produced by controlling the 
brightness of successive dots on the 
individual lines of the raster. 

read: To transfer information into 
the computer’s memory from a 
source external to the computer 
(such as a disk drive or modem) or 
into the computer’s processor from a 
source external to the processor 
(such as the keyboard or main 
memory). 

read-only memory: Memory 
whose contents can be read but not 
written; used for storing firmware. 
Information is written into read-only 
memory once, during manufacture; 
it then remains there permanently, 
even when the computer’s power is 
turned off, and can never be erased 
or changed. Compare read-write 
memory, random-access 
memory, write-only memory. 


read-write memory: Memory 
whose contents can be both read 
and written; often misleadingly 
called random-access memory , or 
RAM. The information contained in 
read- write memory is erased when 
the computer’s power is turned off, 
and is permanently lost unless it 
has been saved on a more 
permanent storage medium, such as 
a disk. Compare read-only 
memory, random-access 
memory, write-only memory. 

receive data register: A read-only 
register in each serial port ACIA (at 
location $C098 for port 1 and $C0A8 
for port 2) that stores the most 
recent character successfully 
received. 

register: A location in a computer 
processor where an item of 
information, such as a byte, is held 
and modified under program 
control. Registers in the 65C02 
microprocessor include the 
accumulator (A), two index 
registers (X and Y), the stack 
pointer (S), the processor status 
register (P), and the program 
counter (PC). The PC register holds 
two bytes (16 bits); the other 
registers hold one byte (8 bits) each. 

remote: Too distant for direct 
connection using wires or cables 
only. 


Request To Send: An RS-232-C 
signal from a DTE to a DCE to 
prepare the DCE for data 
transmission. 

return address: The point in a 
program to which control returns on 
completion of a subroutine. 

RF modulator: See 
radio-frequency modulator. 

RI: See Ring Indicator. 

rigid disk: A disk made of a hard, 
nonflexible material. Compare 

flexible disk. 

Ring Indicator: An optional 
RS-232-C signal from a DCE to a 
DTE that indicates the arrival of a 
call. 

ROM: See read-only memory. 

routine: A part of a program that 
accomplishes some task subordinate 
to the overall task of the program. 

RS-232-C: A standard created by 
the Electronic Industries 
Association (EIA) to allow devices 
of different manufacturers to 
exchange serial data— particularly 
via telephone lines. 

RTS: See Request To Send. 
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run: (1) To execute a program. 

(2) To load a program into main 
memory from a peripheral storage 
medium, such as a disk, and 
execute it. 

save: To transfer information from 
main memory to a peripheral 
storage medium for later use. 

screen: See display screen. 

scroll: To change the contents of 
all or part of the display screen by 
shifting information out at one end 
(most often the top) to make room 
for new information appearing at 
the other end (most often the 
bottom), producing an effect like 
that of moving a scroll of paper past 
a fixed viewing window. See 
viewport, window. 

serial interface: An interface in 
which information is transmitted 
sequentially, one bit at a time, over 
a single wire or channel. Compare 

parallel interface. 

setup time: The amount of time a 
signal must be valid in advance of 
some event; compare hold time. 

silicon: A nonmetallic, 
semiconducting chemical element 
from which integrated circuits are 
made. 


soft switch: A means of changing 
some feature of the Apple lie from 
within a program; specifically, a 
location in memory that produces 
some special effect whenever its 
contents are read or written. 

software: Those components of a 
computer system consisting of 
programs that determine or control 
the behavior of the computer. 
Compare hardware, firmware. 

source code: See source 
program. 

source program: The original 
form of a program given to a 
language translator such as a 
compiler or assembler for 
conversion into another form; 
sometimes called source code. 
Compare object program. 

space character: A text character 
whose printed representation is a 
blank space, typed from the 
keyboard by pressing the SPACE 
bar. 

SPACE parity: A bit of value 0 
appended to a binary number for 
transmission. The receiving device 
can look for this value on each 
character as a means of error 
checking. 


stack: A list in which entries are 
added or removed at one end only 
(the top of the stack), causing them 
to be removed in LIFO 
(last-in-first-out) order. 

start bit: A transition from a 
MARK signal to a SPACE signal for 
one bit-time, indicating that the 
next string of bits represents a 
character. 

status register: A register in an 
ACIA (at location $C099 for port 1 
and $C0A9 for port 2) that stores the 
state of two of the RS-232-C signals 
and the state of the transmit and 
receive data registers, as well as the 
outcome of the most recent 
character transfer. 

stop bit: A MARK signal following 
a string of data bits (or their 
optional parity bit) to indicate the 
end of a character. 

string: An item of information 
consisting of a sequence of text 
characters. 

strobe: (1) An event, such as a 
change in a signal, that triggers 
some action. (2) A signal whose 
change is used to trigger some 
action. 

subroutine: A part of a program 
that can be executed on request 
from any point in the program, and 
which returns control to the point of 
the request on completion. 
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television receiver: A display 
device capable of receiving 
broadcast video signals (such as 
commercial television) by means of 
an antenna. Can be used in 
combination with a radio-frequency 
modulator as a display device for 
the Apple lie computer. Compare 
video monitor. 

terminal: A device consisting of a 
typewriterlike keyboard and a 
display device, used for 
communicating between a computer 
system and a human user. Personal 
computers such as the Apple lie 
typically have all or part of a 
terminal built into them. 

terminal mode: An operating state 
of the Apple lie communication port 
in which the firmware makes the 
computer act like a simple ASCII 
terminal. 

text: (1) Information presented in 
the form of characters readable by 
humans. (2) The display of 
characters on the Apple He’s display 
screen. Compare graphics. 

text window: An area on the 
Apple He’s display screen within 
which text is displayed and scrolled. 


transistor-to-transistor logic: 

(1) A family of integrated circuits 
used in computers and related 
devices. (2) A standard for 
interconnecting such circuits that 
defines the voltages used to 
represent logical Os and Is. 

transmit data register: A 

write-only register in one of the 
serial port ACIAs (at location $C098 
for port 1 and $C0A8 for port 2) that 
holds the current character to be 
transmitted. 

troubleshoot: To locate and 
correct the cause of a problem or 
malfunction in a computer system. 
Typically used to refer to 
hardware-related problems; 
compare debug. 

TTL: See 

transistor-to-transistor logic. 

unary operator: An operator that 
applies to a single operand; for 
example, the minus sign ( — ) in a 
negative number such as — 6 is a 
unary arithmetic operator. 

user: The person operating or 
controlling a computer system. 

user interface: The rules and 
conventions by which a computer 
system communicates with the 
person operating it. 


vector: (1) The starting address of 
a program segment, when used as a 
common point for transferring 
control from other programs. (2) A 
memory location used to hold a 
vector, or the address of such a 
location. 

video: (1) A medium for 
transmitting information in the form 
of images to be displayed on the 
screen of a cathode-ray tube. 

(2) Information organized or 
transmitted in video form. 

video monitor: A display device 
capable of receiving video signals by 
direct connection only, and which 
cannot receive broadcast signals 
such as commercial television. Can 
be connected directly to the 
Apple lie computer as a display 
device. Compare television 
receiver. 

viewport: All or part of the display 
screen, used by an application 
program to display a portion of the 
information (such as a document, 
picture, or worksheet) that the 
program is working on. Compare 
window. 
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warm start: The process of 
restarting the Apple lie after the 
power is already on, without 
reloading the operating system into 
main memory and often without 
losing the program or information 
already in main memory. Compare 
cold start. 

window: The portion of a collection 
of information (such as a document, 
picture, or worksheet) that is visible 
in a viewport on the display screen; 
compare viewport. 

word: A group of bits of a fixed size 
that is treated as a unit; the number 
of bits in a word is a characteristic 
of each particular computer. 


wraparound: The automatic 
continuation of text from the end of 
one line to the beginning of the next, 
as on the display screen or a printer. 

write: To transfer information from 
the computer to a destination 
external to the computer (such as a 
disk drive, printer, or modem) or 
from the computer’s processor to a 
destination external to the processor 
(such as main memory). 

X register: One of the index 
registers in the 65C02 
microprocessor. 

Y register: One of the index 
registers in the 65C02 
microprocessor. 


zero page: The first page 
(256 bytes) of the Apple He’s 
memory, also called page $00. Since 
the high-order byte of any address 
in this page is 0, only the low-order 
byte is needed to specify a zero-page 
address; this makes zero-page 
locations more efficient to address, 
in both time and space, than 
locations in any other page of 
memory. 
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any-key-down (AKD) 72, 227-228 
Apple II series 

comparisons among 336-352 
ID bytes 338 

port I/O differences 66-69 
Applesoft BASIC 317 
prompt character for 55 
Applesoft BASIC interpreter 13 
addresses 234 
and line length 56 
firmware addresses 21 
arithmetic, hexadecimal 199 
arrow keys 4, 56 
ASCII character set 
andMouseText 84 
code conversions 381-384 
code equivalents 370-371 
codes 74-75 
ASCII input mode 193 
asterisk (*) 55, 188 
AUD 240 

audio output jack 2, 7, 240, 346 
auto-answer operation 167 
auto-eject feature 129 
automatic repeat 3 
auxiliary RAM 20 
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B 

B command 145, 157 
back panel 8-9 
backslash (\) 55,58 
backspace 58-59 
BadCmd $01 error 130, 131 
bank selector switches 25-33 
bank-switched memory 22-23 
BASIC 

and analog inputs 186 
and serial port 1 145 
and switch inputs 185 
Applesoft 317 
Integer 317 

prompt character for 55 
restarting from 113 
support for mouse 182 
BASIC program(s) 
and mouse 175 
and MouseText 83 
exiting from 63 
invoking Monitor from 188 
returning to from Monitor 188 
baud rate(s) 152, 261, 262 
setting 145, 157 
Bell routine 78 
Belli routine 78 
bit values 374-375 
bit-mapping 89 

black-and-white monitor, and colors 
87, 89-90 

blanking intervals 241 
BREAK character 147, 159 
BREAK signal 152 
BRK ($00) instruction(s) 70 
handling 325 
BRK vector 70 
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buffering 
keyboard 329 
serial 331 
buffer(s) 
alignment 59 
display 34, 36 
input 34, 36 
pointer 58 
built-in disk drive 8 
built-in firmware routines, calling 52 
BusErr $06 error 116 
button interrupt mode 176 
bytes 375 

c 

C command 146, 158 

Cflag 116,141 

C3COutl routine 59, 61 

C3KeyIn routine 54 

cables, attaching 8 

CALL -151 command 112, 188 

Canadian keyboard 363 

cancel line 58 

I caps lock] key 5 

carriage return 146, 153, 158, 166 

carrier 152 

CH (cursor horizontal) 60 
character modifier keys 76 
character output switch (CSW) 53 
character set(s) 
alternate 65,82 
primary 65,82 
specifications 81 
characters 
control 5 
dimensions of 82 
flashing 64, 82 
inverse 64,82 
MouseText 65, 83 
normal 64,82 
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C1EOLZ routine 105 
ClrEOL routine 105 
ClrEOP routine 105 
ClrScr routine 105 
ClrTop routine 105 
clamping boundaries, mouse 182 
ClampMouse routine 180 
CLC instruction 41 
ClearMouse routine 180 
clock rate 220 
clock signals 223-225 
clock source 261, 262 
CLOSE call 132 
cold-start reset 48-49, 130 
cold-start routine 113 
colors 

double-high-resolution 92 
high-resolution 90, 251-252 
low-resolution 88, 250 
column-address strobe (CAS) 236 
command characters 
changing 147, 160 
port 1 (CONTROL-I) 145, 147 
port 2 (CONTROL-A) 157,160 
substitute 147, 160 
command register, ACIA 263 
connector slots, peripheral 66 
connectors 8-9 
diskdrive 257 
external power 218 
hand controller 270 
mouse 267 
serial port 261 
video output 254 
CONTINUE BASIC command 199 


Index 


CONTROL call 127-129 
control characters 5 
disabling 57 
reactivating 57 

sending without interception 154 
withC3COutl 61,65 
withCOutl 60,65 
I control i key 4, 5 
control register, ACIA 261-262 
CONTROL-} or] 62,110 
CONTROL-1 or \ 62,110 
CONTROL-! 62 
CONTROL- * or 6 110 
CONTROL-_ 62, 110 
CONTROL-A 157, 160, 166 
CONTROL-B 199 
CONTROL-C 63, 199 
CONTROL-D 145, 157 
CONTROL-E 109 
CONTROL-F 109 
CONTROL-G 60, 61, 77, 78, 109 
CONTROL-H 58, 60, 61, 109 
CONTROL-I 145, 147 
CONTROL-J 60, 61, 109 
CONTROL-K 61, 109, 199 
CONTROL-L 61, 109 
CONTROL-M 60, 61, 109 
CONTROL-N 61, 84, 109 
CONTROL-O 61, 83, 109 
CONTROL-P 199 
CONTROL-Q 61, 80 
CONTROL-R 61, 159 
CONTROL-RESET 49, 188 
CONTROL-S 61 
CONTROL-T 159 
CONTROL-U 62, 76 
CONTROL-V 62, 109, 147, 160 
CONTROL-W 62, 109, 147, 160 


CONTROL-X 58, 62, 76 
CONTROL-Y 62, 109,202 
CONTROL-Z 62, 110 
COut routine 59-60, 106 
COutl routine 59, 60, 106 
CPU 12 

CR (carriage return) 153 
CROut routine 106 
CROutl routine 106 
CSW link 53 
cursor 4 

blinking underscore 166 
block 54 
checkerboard 54 
flashing checkerboard 52 
flashing question mark 145, 157 
inverse plus sign 58 
inverse solid 52 
movement codes 56-57, 60, 61 
movement keys 4.58 
position 59-60 
CV (cursor vertical) 60 

D 

D command 146, 158 
data format, setting 146, 158 
data inputs 21 

Data Terminal Ready, setting levels for 
263 

data transfer 261 

DB-9 connector 175, 184-185, 266, 270 
DB-15 connector 81, 254 
DB-19 connector 256-257 
debugging programs 205-207 
1 delete l key 4 

device control block (DCB) 121, 129 
device identification bytes 67 


device information block (DIB) 
121-122 

DHiRes switch 44, 96 
DIN jacks 260 

disk controller unit (IWM) 231 
disk drive 8 

I/O firmware entry points 21 
speed adjustment 13 
disk-use light 7 
display 

double-high-resolution 252-253 
high-resolution 251 
low-resolution 250 
display address transformation 243 
display format(s) 82, 198 
inverse 61 
normal 61 
specifications 81 
display memory 
addressing 242 
maps 98-99 
switches 43-44 
display mode specifications 81 
display page(s) 
addressing 98-99 
HRP1 36, 93 
HRP1X 36, 93 
HRP2 37, 93 
HRP2X 37 
locations 94 

switches for selecting 43-44 
TLP1 34, 93 
TLP1X 36, 93 
TLP2 36, 93 
TLP2X 36 

display soft switches 95-96 
DisVBl switch 177 
DisXY switch 177 


DOS 316 

double-high-resolution graphics 91, 

103 

generating 252-253 
specifications 81 

double-low-resolution graphics 94 
Q] key 4, 153 
Dvorak keyboard 5-6, 358 
dynamic RAM refreshment 235 
dynamic RAM timing 236-237 

E 

echoing 263 
editing features 
backspace 58 
cancel line 58 
retype 59 
80Col switch 95 
80-column display 84, 93 
address mapping 242-243 
addressing 247 
and CH value 60 
and Monitor 80 
left margin value 63 
map of 100 
switching to 5, 57, 61 
timing signals 249 
width value 63 
80/40 switch 5, 80 
80Store switch 43, 95 
EnbXY switch 177 
English keyboard 360 
enhanced video firmware 64, 65, 69, 80 
entry points 
firmware 20-21 
for ports 66 
Monitor 313-314 
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EnVBl switch 177 
error codes, Protocol Converter 
141-142 
[esc] key 56 
escape mode 56-58 
even parity 152 
EXAMINE command 197 
external drive startup 114 
EXTINT line 121 

F 

F command 146, 158 
firmware 

addresses 311-313 
entry points 20-21,66 
listings 385-470 
mapping 64-65 
protocol 67, 108, 162, 181 
firmware routines 
calling 52 
input 54-55 
mouse 180 
output 59 
video 104-110 
flag inputs 21 
flags 16,21 

flashing characters 64, 82 
flashing power light 7 
flashing question mark 145,157 
folded address bits 244 
forced cold-start reset 48-50 
FORMAT call 126 
FORTRAN 317 
40-column display 
address mapping 242-245 
addressing 247 
left margin value 63 
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map of 99 

memory locations 245 
switching to 5,57,61 
timing signals 248 
width value 63 

with double-high-resolution graphics 
91 

48K memory 34-35 
switches 37 
French keyboard 361 
full-duplex operation 168-169 

G 

game input characteristics 184 
general logic unit (GLU) 230 
German keyboard 364 
GetLn routine 55-56 
GetLnl routine 56, 76 
GetLnZ routine 76 
GLU (general logic unit) 230 
GO command 203 
graphics display 
double-high-resolution 91 
double-low-resolution 94 
high-resolution 88-89 
low-resolution 87 
graphics routines 37 
grounding 217, 371 

H 

half-duplex operation 167-168 
hand controller(s) 
and mouse 183-184 
circuits 272 
connector 270, 271 
signals 185-186, 270, 273 


Index 


handle 8 

headphone jack 2,7,240,346 
hexadecimal 
arithmetic 199 
converting to decimal 376 
converting to negative decimal 377 
high-resolution graphics 88-89 
display map 102 
generating 251 
specifications 81 
storing in memory 89 
HiRes switch 43, 96 
HLine routine 106 
HOME routine 106 
HomeMouse routine 180 
horizontal-count bits 244 
HRP1 36, 93 
HRP1X 36, 93 
HRP2 37, 93 
HRP2X 37 

1 

I command 146, 158 
I/O firmware entry points 20-21 
I/O ROM space 69 
I/O subroutines, calling 52 
identification (ID) bytes 
Apple II series 338 
device 67 

IN #2 command 156, 157, 166 
IN#6 command 112 
IN #n command 53, 66 
index register(s) 16, 202 
indirect addressing 24 
INIT call 130 
InitMouse routine 180 
input buffer 34 


input subroutines 
GetLn 55-56 
GetLnl 76 
GetLnZ 76 
Keyln 54 
RdChar 76 
RdKey 54 

input/output unit (IOU) 227-228 
inputs 
analog 186 
data 21 
flag 21 
switch 185 

Integer BASIC, prompt character for 
55 

integrated circuits 12 
Integrated Woz Machine (IWM) 231 
internal voltage converter 219-220 
interrupt handler, Monitor 70 
interrupt(s) 70, 223 
allowing 263 

Apple lie support for 320-321 

causes of 321 

handling 322-324, 327-332 

sources of 326 

VBlInt 178 

XInt 178 

YInt 178 

inverse characters 64, 82 
INVERSE command 83, 198 
inverse flag 64, 65 
values 65 

IOU (input/output unit) 227-228 

IOUDis switch 44,95,96, 177 

IRQ vector 70 

ISO keyboard layout 359 

Italian keyboard 366 

IWM (Integrated Woz Machine) 231 


J 

jack(s) 

audio output (headphone) 2, 7, 240, 
346 
DIN 260 
phono 81 

JMP indirect instruction 283 
joysticks See hand controller(s) 
jump table, constructing 68 

K 

K command 146, 158 
keyboard 3 
characteristics 73 
circuit diagram 238 
disabling 146, 158 
enabling 146, 158 
encoder 72 
features 3 

interrupts from 328-330 
layout(s) 3, 5-6, 354-369 
operation of 237-238 
signals 239 
specifications 4 
switch 5 

keyboard input switch (KSW) 53 
keyboard strobe 
clearing 72-74 
reading 72 
Keyln routine 54-55 
keys 

cursor movement 4 
modifier 5, 76 
special function 4 
KSW link 53 


Index 


L 

L command 146 
last opened location 189 
(3 key 4,58 
line feed (LF) 153,166 
disabling 146, 158 
enabling 146, 158 
masking 146, 158 
line width 153 
setting 145, 146, 157, 158 
LIST command 204-205,210 
LogoII 318 
loudspeaker 7 
low-resolution graphics 87 
display map 101 
generating 250 
specifications 81 
storing in memory 87 

M 

M command 146, 158 
machine-language programs 203-205 
main RAM 20 
maps 

Apple lie memory 19 
bank-switched memory 23 
double-high-resolution graphics 
display 103 

80-column text display 100 
40-column text display 99 
48K memory 35 

high-resolution graphics display 102 
low-resolution graphics display 101 
MARK parity 152 


T 


memory 
addressing 232 
bank-switched 22-23 
changing contents of 192-194 
comparing data in 196 
displaying contents of 190-192 
dump 190-192 
48K 34-35 
map 19 

moving data in 194-195 
range 191 

memory address(es) 18 
controlling text window 63 
for data I/O 68 
for display modes 245 
hardware 21-22 
hardware page 303-307 
of text displays 247 
page $00 294-297 
page $03 298 
port screen hole 69-70 
RAM 20, 234-237 
ROM 20,233-234 

transforming display data into 242 
memory bus organization 233 
memory management unit (MMU) 
225-226 
memory pages 
$00 (zero page) 18,24 
$01 (stack) 18, 24 
$02 (input buffer) 34 
$03 (global storage, vectors) 34 
$04-$07 (TLP1) 34 
$08 (communication port buffers) 
36 

$08-$0B (TLP2) 36 
$20-$3F (HRP1) 36 
$40-$5F (HRP2) 37 
$DO-$FF (ROM and RAM) 24 


memory switches 
addresses of 21-22 
bank selector 25-33 
display 43-44 
48K 37 

hardware functions of 21-22 
microprocessor 12, 16 See also 65C02 
microprocessor 
Mini-Assembler 207 
instruction formats 210-211 
leaving 210 
starting 208 
using 209-210 
MIXED switch 91,95 
mixed-mode displays 91 
MMU (memory management unit) 
225-226 
mode bytes 179 
modem, baud rate of 262 
modem communication 165 
modem port See port 2 
monitor 

black-and-white 80, 87, 89 
color 80, 87, 89-90 
television set as 80, 84, 87, 89-90 
Monitor 

firmware addresses 21 
interrupt handling by 70 
keyboard support 72 
memory location of 188 
prompt character for 55 
Monitor commands 
for debugging 205-207 
for machine-language programs 203 
memory commands 189-196 
register commands 197 
repeating 201-202 
syntax of 189 


Monitor subroutines 
for game input 186 
for input 54, 76 
for output 59, 78 
for video display 104-110 
mouse 
circuits 268 
disabling 182 
enabling 179 
firmware entry points 21 
firmware routines 180 
interrupt handler 178 
interrupts 333 
movement signals 176 
operation of 265 
port characteristics 174 
screen hole locations 182 
soft switches 177-178 
waveforms 266 

MouseText graphics characters 65, 83 
and ASCII characters 84 
disabling 62 
printing 84 
MouXI switch 178 
MouYI switch 178 
MOVE command 194, 200-201 
MoveAux routine 40-41 
movement interrupt mode 175-176 
movement/button interrupt mode 176 
multiplexing 235 
RAM address 236 

N 

N command 146, 158 
n CONTROL-K 53 
n CONTROL-P 53 
newline 

enabling or disabling 129 
status 121 
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next changeable location 189 
nibbles 375 

normal characters 64, 82 
NORMAL command 84, 198, 200 
NTSC 90, 241 
#6 command 145 

0 

odd parity 152 
1 CONTROL-P command 144 
[6] key 4,50,76 
fol - l CONTROL 1 - 1 RESET | 49-50 
OPEN call 131 
operating systems 53 
output jack 240 
output subroutines 
Bell 78 
Belli 78 
COut 59-60 
COutl 60 
C3COutl 61 

for video display 104-110 
overheating 216 

P 

P command 147, 159 
P register 16 
paddle values 274 
Page 1 

high-resolution (HRP1) 36, 93 
text and low-resolution (TLP1) 34, 
93 

Page IX 

high-resolution (HRP1X) 36, 93 
text and low-resolution (TLP1X) 36, 
93 


Page 2 

high-resolution (HRP2) 37, 93 
text and low-resolution (TLP2) 36, 
93 

Page 2X 

high-resolution (HRP2X) 37 
text and low-resolution (TLP2X) 36 
Page2 switch 43, 95 
pages, display See display pages 
pages, memory See memory pages 
PAL 241 

parity, setting 147, 159 
parity bit 152 
parity checking 263 
Pascal 317 

and external drive startup 114 
and I/O links 53 
and printer output 145 
and window widths 63 
firmware protocol 67 
ID byte 149,162, 181 
operating system 316 
support for mouse 181 
transferring files to modem with 
157 

PC (program counter) 16 
PdlO 186 
Pdll 186 

PEEK xxxi, 185, 317 
peripheral connector slots 66 
peripheral identification numbers 
(PIN) 378-379 
PInit routine 67, 108 
entry point of 149, 162 


pinouts 
GLU 230 
IOU 227 
IWM 231 
MMU 226 
6551 260 
TMG 229 

video expansion connector 255 
PLOT routine 106 
POKE 317 
port 1 

characteristics 144 
characteristics storage 151 
commands 145-147 
configuration at startup 148 
firmware protocol 149 
hardware addresses 149 
screen hole locations 150 
port 2 

characteristics 156 
characteristics storage 163 
commands 157-159 
configuration at startup 160 
firmware protocol 162 
hardware addresses 161 
screen hole locations 162 
port routine requirements 68 
ports 

serial port 1 20 
serial port 2 20 
PosMouse routine 180 
power light 7 

power supply 10-11, 217-218, 219 
50-Hz 372 
power switch 8 
power-on reset 48-49 
power-up byte 50 
PR#1 command 144, 145, 156 
PR#2 command 156, 157 
PR#3 command 83 
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PR#6 command 112,113 
PR#n command 53, 66 
PrB12 routine 107 
PrByte routine 107 
PRead routine 67, 109, 186 
entry point of 149, 162 
PrErr routine 107 
PrHex routine 107 
primary character set 64, 65, 82 
PRINT CHR$(24) 83 
PRINT CHR$(27) 83 
PRINTER command 145 
printer port See port 1 
PrntAX routine 107 
processor 12 

processor status register 16 
ProDOS 316 

program counter (PC) 16, 208 
prompt characters 55 
protocol, firmware 67 
for mouse port 181 
for port 1 149 
for port 2 162 
for port 3 108 
Protocol Converter 
calls to 117-118 
entry point 115 
PStatus routine 68, 110 
entry point of 149, 162 
PTrig switch 177 
PWrite routine 67, 109 
entry point of 149, 162 

Q 

Q command 159 
question mark (?) 55 
quitting terminal mode 159 


R 

R command 147, 159 
RAM address(es) 20 
multiplexing 236 
RAM addressing 234-237 
RAMRd switch 37 
RAMWrt switch 37 
random-number routine 55 
RCA-type phono jack 81 
Rd80Col switch 95 
Rd80Store switch 43, 95 
RdAltChar switch 95 
RdAltZP switch 26 
RdBnk2 switch 26 
RdBtnO switch 178 
RdChar routine 76 
RdDHiRes switch 44, 96 
RdHiRes switch 43, 96 
RdlOUDis switch 44, 96, 177 
RdKey routine 54 
RdLCRAM switch 26 
RdMIXED switch 95 
RdPage2 switch 43, 95 
Rd63 switch 178 
RdTEXT switch 95 
RdVBIMsk switch 177 
RdXOEdge switch 177 
RdXYMsk switch 177 
RdYOEdge switch 177 
READ BLOCK call 123-124 
READ call 133-134 
ReadMouse routine 180 
receiver clock source 261,262 
registers 16 
changing 197 
examining 197 
remote mode 171 


Request To Send (RTS) 263 
1 reset l key 4, 47, 76 
reset routine 47-48 
reset vectors 48-50 
reset(s) 

cold-start (power-on) 49, 130 
forced cold-start 49-50 
warm-start 49, 128 
I return l key 4 
RF video modulator 80 
ROM addresses 20-21 
ROM addressing 233-234 
row-address strobe (RAS) 236 
RstVBl switch 177 
RstXInt switch 177 
RstXY switch 177 
RstYInt switch 177 
RTS (Request To Send) 263 

S 

S command 147, 159 
S register 16 

safety instructions 217,371 
schematic diagrams 274-280 
screen alignment 59 
screen hole locations 36, 69-70, 298 
in auxiliary memory 301 
in main memory 299-300 
mouse port 182 
portl 150 
port 2 162 
SCRN routine 107 
scrolling 60-62 
SEC instruction 41 
serial portl 20 
serial port 2 20 
serial port circuits 258 
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ServeMouse routine 175, 180 
SetCol routine 107 
SetMouse routine 179, 180 
SetPWRC routine 50 
I shift | key 5 
Sholes keyboard 5-6, 355 
6 CONTROL-K command 112 
6 CONTROL-P command 83, 112, 113 
65C02 microprocessor 12 
block diagram of 220 
data sheet for 283-292 
registers 16 
specifications 223 
versus 6502 282-283 
signals 

character-generator control 250 
disk drive connector 257 
external power connector 218 
14-MHz video timing 249 
GLU 230 

hand controller 273 

hand controller connector 271 

IOU 227 

IWM 231 

keyboard 239 

memory selection 233 

MMU 226 

mouse button 269 

mouse connector 267 

RAM timing 236-237 

serial port connector 261 

7-MHz video timing 248 

65C02 timing 223-225 

6551 260 

TMG 229 

video output 253-256 
slot equivalents 66 


soft switches 18,22 
bank selector 25 
display 95-96 
display memory 43, 44 
48K memory 37 
hardware functions of 21-22 
memory addresses of 21-22 
mouse 177-178 
resetting to normal 47-48 
speaker 77 
(*] 4, 50, 76 
SPACE parity 152 
speaker 

characteristics 77 
operation of 240 
toggle 22 
using 77 

volume control 7, 240 
special function keys 4 
specifications 
environmental 216-217 
50-Hz power supply 372 
internal converter 219 
keyboard 4 
power supply 218 
65C02 microprocessor 223 
video display 81 
speed adjustment, disk drive 13 
stack 18,24 
stack pointer 16 
standard (Sholes) keyboard 5-6 
start bit 152 
startups 

cold-start routine 113 
from external drive 114 
warm-start routine 113 
STATUS call 119-123 
status register, ACIA 264 
STEP command 205-207 


stop-list function 61,62-63 
strobe 
inputs 21 
outputs 22 

Super Serial Card 144, 156, 349 
SwO 185 
Swl 185 

switch inputs 185,270 
switches 

address space (memory) 21-22 
bank selector 25-33 
character output 53 
keyboard input 53 
soft 18, 21-22 
sync pulses 241 
synchronization signals 241 

T 

T command 159 
[tab] key 4 
television set 
and colors 87,89-90 
and display width 84 
and high-resolution graphics 90 
as monitor 80 
vertical line count and 242 
terminal mode 159,166,171 
text capacity specifications 81 
text display(s) 
characteristics 86 
80-column 5, 80, 84, 93 
40-column 5, 80, 84, 93 
generating 247 
switching 86 
text modes 82 
TEXT switch 91,95 
text window 
changing 63 

values for parameters 64 
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timing generator (TMG) 229 
timing signals 223-225 
TLP1 34, 93 
TLP1X 36, 93 
TLP2 36, 93 
TLP2X 36 

TMG (timing generator) 229 
TMG chip 262 
toggle switches 22 
TRACE command 205-207 
transmit/receive register, ACIA 265 
transparent mode 175 
2 CONTROL-P command 156 
two-key rollover 113 

U 

UniDisk3.5 112 
and mouse interrupts 179 
and slot 7 348 
cold starts with 50 
communicating with 114-115 
debugging commands 205-207 
ROM size 233-234 
starting up from 113,114 
USER command 202 


V 

validity-check byte 49, 50 
VBlInt signal 175, 178 
vectors, Monitor 313-314 
ventilation 8 

VERIFY command 196, 201 
vertical blanking active modes 176 
vertical-countbits 244 
video control functions 109-110 
video counters 
horizontal 241-242 
vertical 242 
video display 
operation of 241 
specifications 81 

video output firmware entry points 20 

video port characteristics 80 

video signal 81 

VLine routine 108 

voltage converter 10-11 

voltages 

50-Hz power supply 372 
internal converter 219-220 
power supply 218 
65C02 microprocessor 223 
volume control 7, 240 
VTab 60 

W 

warm-start reset 49, 128 
warm-start routine 113 
Western Spanish keyboard 368 
WRITE BLOCK call 124-125 
WRITE call 134-135 
write-enable addresses 25 
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X 

X command 147, 159 

X register 16 

and port routines 68 

XI 266 

XFer routine 40-42 
XInt 178 
X0 176, 265 
XOEdge switch 177 
XON/XOFF protocol 147,159 

Y 

Y register 16 

and port routines 68 
Y1 266 
YInt 178 
Y0 176, 265 
YOEdge switch 177 

Z 

Z command 147, 154, 159 
zapping command characters 147, 154, 
159 

zero page 18,24 
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Tell Apple About the Apple lie 
Technical Reference Manual 


Your Name: 
Your Title: _ 
Company: _ 
Address: 


Apple uses comments and suggestions from Apple computer 
owners like you to improve existing products and develop new 
and better products. Now that you’ve used this product, we 
want to know your suggestions and thoughts about your 
experience. Please use this form to tell Apple what you think. 


City/State/Zip: 
Work Phone: _ 
Home Phone: _ 


Your Dealer Can Help: Apple can’t respond to your 
individual questions. If you have a question, would like help, 
or need service, please contact your Apple dealer. 


Part 1: Tell Apple About You 

1. How many years have you been using Apple computers? 

□ <1 □ 1-2 □ 3-5 □ Since 19 

2. Where do you use your Apple computer? Check all that 
apply. 

EH Home EH Work EH School 

□ Other 


3. How many people in your family /office use your Apple 
computer? 

Adults Children 

4. Which of these best describes you? 

ED Computer Enthusiast/Hobbyist ED Student 
ED Professional Programmer ED Other 


Part 2: Tell Apple About Your System 

1. How much memory does your Apple lie have? K 

2. Please list the date of purchase 

3. Please list devices attached to your computer. 

Type/Brand 

ED Monochrome Monitor i 

D Color Monitor 

ED 514-Inch Disk Drive 

! 1 su-incb Disk tV'Vp 

ED Mouse 

ED Modem 

ED Printer 

ED Other 


4. Do you plan to write computer programs? ED Yes ED No 
If yes, which computer languages will you use? 


5. Please give us any suggestions or comments and tell us about 
any problems you’ve had with your Apple computer. 


Part 3: Tell Apple About This Product 

Please take a few minutes to tell Apple what you think about 
the Apple lie Technical Reference Manual. 

1. Where did you buy this manual? 

ED At an authorized Apple dealer. ED In a bookstore. 

ED Through the mail. ED Other 

2. What do you use this manual for? 

ED General information about the machine. 

ED Information about selected features of the machine. 

ED Other 

3. What will you use the information for? 

ED Connect and run some hardware. 

ED Write software for yourself. 

ED Write software for sale. 

ED Write software to share with associates. 

ED Develop hardware you can attach to your Apple lie. 

ED Develop hardware for sale. 

ED Other 


4. How have you read this manual? 

ED The whole manual from cover to cover. 

ED Whole chapters at a time. 

ED Only specific sections as needed. 

D Other 

5. Which aids do you use to find what you are looking for? 

D Table of Contents ED List of Figures and Tables 
D Reference tables at beginning of Chs. 4-9. 

ED The Index ED Other 

6. Which of the figures or tables did you find the most useful? 


7. What other books have you used to supplement the 
information in this manual? 


8. Overall, how would you rate this manual? 

Low High 

123456789 10 


Thank you for taking time to Tell Apple. 


Apple Computer, Inc. 

P.O. Box 1143 
Cupertino, CA 95014 


